clodds 1.1.0

package/dist/skills/executor.js

@@ -0,0 +1,469 @@
+"use strict";
+/**
+ * Skill Executor - Central registry for all 110 bundled CLI skill handlers.
+ *
+ * ARCHITECTURE:
+ * - Each skill lives in src/skills/bundled/<name>/index.ts
+ * - Each skill exports default { name, description, commands, handle|handler }
+ * - Skills are loaded lazily via dynamic import() on first use
+ * - Each skill is loaded in its own try/catch so one broken skill can't crash others
+ * - Skills can declare `requires: { env: ['VAR'] }` for pre-flight env checks
+ *
+ * ADDING A NEW SKILL:
+ * 1. Create src/skills/bundled/<name>/index.ts with default export
+ * 2. Add the directory name to SKILL_MANIFEST below
+ * 3. Run `npx tsc --noEmit` to verify
+ *
+ * SKILL HANDLER CONTRACT:
+ * - `handle(args: string)` receives everything AFTER the command prefix
+ *   e.g., "/bf balance" calls handle("balance")
+ * - Must return a Promise<string> (the response text)
+ * - Both `handle` and `handler` method names are accepted (normalizeSkill handles both)
+ * - commands can be string[] or {name, description, usage}[] (normalized to string[])
+ *
+ * BACKING MODULES:
+ * - Most skills wrap real modules in src/ (e.g., execution/, trading/, feeds/, etc.)
+ * - Skills use dynamic imports (await import(...)) inside try/catch so the CLI
+ *   still works even if a backing module's dependencies aren't installed
+ * - When a backing module can't load, the skill falls through to help text
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDispatchSkill = registerDispatchSkill;
+exports.clearDispatchSkills = clearDispatchSkills;
+exports.getSkillManifest = getSkillManifest;
+exports.executeSkillCommand = executeSkillCommand;
+exports.getRegisteredSkills = getRegisteredSkills;
+exports.getSkillByCommand = getSkillByCommand;
+exports.isSkillCommand = isSkillCommand;
+exports.getSkillCommands = getSkillCommands;
+exports.getFailedSkills = getFailedSkills;
+const logger_1 = require("../utils/logger");
+// =============================================================================
+// SKILL MANIFEST - all bundled skill directory names
+// =============================================================================
+const SKILL_MANIFEST = [
+    'acp',
+    'agentbets',
+    'ai-strategy',
+    'alerts',
+    'analytics',
+    'arbitrage',
+    'auto-reply',
+    'automation',
+    'backtest',
+    'bags',
+    'bankr',
+    'betfair',
+    'binance-futures',
+    'botchan',
+    'bridge',
+    'bybit-futures',
+    'clanker',
+    'copy-trading',
+    'copy-trading-solana',
+    'credentials',
+    'crypto-hft',
+    'divergence',
+    'doctor',
+    'drift',
+    'drift-sdk',
+    'edge',
+    'embeddings',
+    'endaoment',
+    'ens',
+    'erc8004',
+    'execution',
+    'farcaster',
+    'features',
+    'feeds',
+    'harden',
+    'history',
+    'hyperliquid',
+    'identity',
+    'integrations',
+    'jupiter',
+    'kamino',
+    'ledger',
+    'market-index',
+    'markets',
+    'mcp',
+    'memory',
+    'metaculus',
+    'meteora',
+    'meteora-dbc',
+    'metrics',
+    'mev',
+    'mm',
+    'mexc-futures',
+    'monitoring',
+    'news',
+    'onchainkit',
+    'opinion',
+    'opportunity',
+    'orca',
+    'pairing',
+    'percolator',
+    'permissions',
+    'plugins',
+    'portfolio',
+    'portfolio-sync',
+    'positions',
+    'predictfun',
+    'predictit',
+    'presence',
+    'processes',
+    'pump-swarm',
+    'pumpfun',
+    'qmd',
+    'qrcoin',
+    'raydium',
+    'remote',
+    'research',
+    'risk',
+    'router',
+    'routing',
+    'sandbox',
+    'search-config',
+    'sessions',
+    'signals',
+    'sizing',
+    'slippage',
+    'smarkets',
+    'strategy',
+    'streaming',
+    'tailscale',
+    'ticks',
+    'trading-evm',
+    'trading-futures',
+    'trading-kalshi',
+    'trading-manifold',
+    'trading-polymarket',
+    'trading-solana',
+    'trading-system',
+    'triggers',
+    'tts',
+    'tweet-ideas',
+    'usage',
+    'veil',
+    'verify',
+    'virtuals',
+    'voice',
+    'weather',
+    'webhooks',
+    'whale-tracking',
+    'yoink',
+    // ── New features (Feb 2026) ──
+    'token-security',
+    'dca',
+    'shield',
+];
+/** Normalize skill handler to consistent interface */
+function normalizeSkill(skill) {
+    // Normalize commands array (some skills have {name,description,usage} format)
+    const commands = skill.commands.map((cmd) => typeof cmd === 'string' ? cmd : cmd.name);
+    // Use handle or handler method
+    const handleFn = skill.handle || skill.handler;
+    if (!handleFn) {
+        throw new Error(`Skill ${skill.name} has no handle or handler method`);
+    }
+    // Wrap handler with env-var requirement checking if declared
+    const requiredEnv = skill.requires?.env;
+    let wrappedHandle;
+    if (requiredEnv && requiredEnv.length > 0) {
+        const boundHandle = handleFn;
+        wrappedHandle = async (args) => {
+            const missing = requiredEnv.filter((v) => !process.env[v]);
+            if (missing.length > 0) {
+                return `⚠ ${skill.name} requires environment variables to be set:\n\n${missing.map((v) => `  • ${v}`).join('\n')}\n\nSet them in your environment or .env file to use this skill.`;
+            }
+            return boundHandle(args);
+        };
+    }
+    else {
+        wrappedHandle = handleFn;
+    }
+    return {
+        name: skill.name,
+        description: skill.description,
+        commands,
+        handle: wrappedHandle,
+    };
+}
+// =============================================================================
+// SKILL REGISTRY
+// =============================================================================
+/** Map of command prefix to skill handler */
+const commandToSkill = new Map();
+/** All registered skill handlers */
+const registeredSkills = [];
+/** Track which skills failed to load */
+const failedSkills = [];
+/** Track which skills have env requirements */
+const skillRequirements = new Map();
+/**
+ * Register a skill handler
+ */
+function registerSkill(skill) {
+    try {
+        // Track requirements before normalizing
+        if (skill.requires?.env) {
+            skillRequirements.set(skill.name, skill.requires.env);
+        }
+        const normalized = normalizeSkill(skill);
+        registeredSkills.push(normalized);
+        for (const cmd of normalized.commands) {
+            const normalizedCmd = cmd.toLowerCase().startsWith('/') ? cmd.toLowerCase() : `/${cmd.toLowerCase()}`;
+            commandToSkill.set(normalizedCmd, normalized);
+            logger_1.logger.debug({ skill: normalized.name, command: normalizedCmd }, 'Registered skill command');
+        }
+    }
+    catch (error) {
+        logger_1.logger.error({ skill: skill.name, error }, 'Failed to register skill');
+    }
+}
+// =============================================================================
+// LAZY INITIALIZATION
+// =============================================================================
+let initialized = false;
+let initializing = null;
+/**
+ * Lazily load and register all skills from SKILL_MANIFEST.
+ * Each skill is loaded in its own try/catch so a missing dependency
+ * (e.g., viem, @solana/web3.js) only takes down that one skill.
+ */
+async function initializeSkills() {
+    if (initialized)
+        return;
+    if (initializing)
+        return initializing;
+    initializing = (async () => {
+        const results = await Promise.allSettled(SKILL_MANIFEST.map(async (name) => {
+            try {
+                const mod = await Promise.resolve(`${`./bundled/${name}/index`}`).then(s => __importStar(require(s)));
+                const skill = mod.default || mod;
+                registerSkill(skill);
+                return { name, ok: true };
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                failedSkills.push({ name, error: errorMsg });
+                logger_1.logger.warn({ skill: name, error: errorMsg }, 'Failed to load skill');
+                return { name, ok: false };
+            }
+        }));
+        const loaded = results.filter((r) => r.status === 'fulfilled' && r.value.ok).length;
+        const failed = SKILL_MANIFEST.length - loaded;
+        logger_1.logger.info({ loaded, failed, total: SKILL_MANIFEST.length }, 'Skill initialization complete');
+        if (failed > 0 && failed !== SKILL_MANIFEST.length) {
+            logger_1.logger.warn({ failed, names: failedSkills.map((f) => f.name) }, 'Some skills failed to load (missing dependencies?)');
+        }
+        // Register the built-in /skills command
+        registerBuiltinSkillsCommand();
+        initialized = true;
+    })();
+    return initializing;
+}
+/**
+ * Register the built-in /skills command that shows skill status
+ */
+function registerBuiltinSkillsCommand() {
+    const skillsHandler = {
+        name: 'skills-status',
+        description: 'Show status of all loaded skills',
+        commands: ['/skills'],
+        handle: async (_args) => {
+            const lines = ['# Skill Status\n'];
+            // Ready skills
+            const ready = [];
+            const needsConfig = [];
+            for (const skill of registeredSkills) {
+                if (skill.name === 'skills-status')
+                    continue;
+                const reqs = skillRequirements.get(skill.name);
+                if (reqs && reqs.length > 0) {
+                    const missing = reqs.filter((v) => !process.env[v]);
+                    if (missing.length > 0) {
+                        needsConfig.push(`  ⚙ ${skill.name} — needs: ${missing.join(', ')}`);
+                        continue;
+                    }
+                }
+                ready.push(`  ✓ ${skill.name}`);
+            }
+            lines.push(`## Ready (${ready.length})`);
+            if (ready.length > 0) {
+                lines.push(ready.join('\n'));
+            }
+            if (needsConfig.length > 0) {
+                lines.push(`\n## Needs Configuration (${needsConfig.length})`);
+                lines.push(needsConfig.join('\n'));
+            }
+            if (failedSkills.length > 0) {
+                lines.push(`\n## Failed to Load (${failedSkills.length})`);
+                for (const f of failedSkills) {
+                    // Truncate long error messages
+                    const shortErr = f.error.length > 80 ? f.error.slice(0, 77) + '...' : f.error;
+                    lines.push(`  ✗ ${f.name} — ${shortErr}`);
+                }
+            }
+            lines.push(`\n**Total:** ${registeredSkills.length - 1} loaded, ${failedSkills.length} failed, ${SKILL_MANIFEST.length} in manifest`);
+            return lines.join('\n');
+        },
+    };
+    registerSkill(skillsHandler);
+}
+/** Map of /command → dispatch target for skills with command-dispatch: tool */
+const dispatchMap = new Map();
+/**
+ * Register a SKILL.md skill for direct command dispatch.
+ * Called by the SkillManager when loading skills with command-dispatch: tool.
+ */
+function registerDispatchSkill(command, entry) {
+    const normalized = command.toLowerCase().startsWith('/') ? command.toLowerCase() : `/${command.toLowerCase()}`;
+    dispatchMap.set(normalized, entry);
+    logger_1.logger.debug({ command: normalized, tool: entry.toolName, skill: entry.skillName }, 'Registered dispatch skill');
+}
+/**
+ * Clear all dispatch skill registrations (called on reload).
+ */
+function clearDispatchSkills() {
+    dispatchMap.clear();
+}
+/**
+ * Get the full skill manifest (list of all bundled skill directory names).
+ * Used by MCP server to expose skills as tools.
+ */
+function getSkillManifest() {
+    return [...SKILL_MANIFEST];
+}
+/**
+ * Execute a skill command
+ *
+ * @param message - The full message text (e.g., "/bf balance")
+ * @returns Result of execution
+ */
+async function executeSkillCommand(message) {
+    // Ensure skills are loaded on first invocation
+    await initializeSkills();
+    const trimmed = message.trim();
+    // Check if it's a command
+    if (!trimmed.startsWith('/')) {
+        return { handled: false };
+    }
+    // Parse command and arguments
+    const spaceIndex = trimmed.indexOf(' ');
+    const command = spaceIndex === -1 ? trimmed.toLowerCase() : trimmed.slice(0, spaceIndex).toLowerCase();
+    const args = spaceIndex === -1 ? '' : trimmed.slice(spaceIndex + 1);
+    // Check dispatch map first (command-dispatch: tool skills bypass LLM)
+    const dispatch = dispatchMap.get(command);
+    if (dispatch) {
+        logger_1.logger.info({ skill: dispatch.skillName, command, tool: dispatch.toolName, args }, 'Dispatching skill directly to tool');
+        return {
+            handled: true,
+            skill: dispatch.skillName,
+            dispatch: {
+                tool: dispatch.toolName,
+                args,
+                argMode: dispatch.argMode,
+            },
+        };
+    }
+    // Find matching skill handler
+    const skill = commandToSkill.get(command);
+    if (!skill) {
+        return { handled: false };
+    }
+    try {
+        logger_1.logger.info({ skill: skill.name, command, args }, 'Executing skill command');
+        const response = await skill.handle(args);
+        return {
+            handled: true,
+            response,
+            skill: skill.name,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger_1.logger.error({ skill: skill.name, command, error: errorMessage }, 'Skill command failed');
+        return {
+            handled: true,
+            error: errorMessage,
+            skill: skill.name,
+        };
+    }
+}
+/**
+ * Get all registered skill handlers
+ */
+function getRegisteredSkills() {
+    return [...registeredSkills];
+}
+/**
+ * Get skill handler by command
+ */
+function getSkillByCommand(command) {
+    const normalized = command.toLowerCase().startsWith('/') ? command.toLowerCase() : `/${command.toLowerCase()}`;
+    return commandToSkill.get(normalized);
+}
+/**
+ * Check if a command is handled by a skill (handler or dispatch)
+ */
+function isSkillCommand(command) {
+    const normalized = command.toLowerCase().startsWith('/') ? command.toLowerCase() : `/${command.toLowerCase()}`;
+    return commandToSkill.has(normalized) || dispatchMap.has(normalized);
+}
+/**
+ * Get all registered skill commands
+ */
+function getSkillCommands() {
+    const commands = [];
+    for (const skill of registeredSkills) {
+        for (const cmd of skill.commands) {
+            commands.push({
+                command: cmd,
+                skill: skill.name,
+                description: skill.description,
+            });
+        }
+    }
+    return commands;
+}
+/**
+ * Get list of failed skills (for diagnostics)
+ */
+function getFailedSkills() {
+    return [...failedSkills];
+}
+//# sourceMappingURL=executor.js.map

package/dist/skills/executor.js.map

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

package/dist/skills/frontmatter.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Shared frontmatter parser for SKILL.md files
+ * Supports both Clodds-native and OpenClaw-format frontmatter
+ */
+export interface SkillGates {
+    bins?: string[];
+    anyBins?: string[];
+    envs?: string[];
+    os?: string[];
+    config?: string[];
+}
+export interface ParsedFrontmatter {
+    name?: string;
+    description?: string;
+    emoji?: string;
+    homepage?: string;
+    commands?: string[];
+    metadata?: string;
+    gates?: SkillGates;
+    userInvocable?: boolean;
+    modelInvocable?: boolean;
+    commandDispatch?: 'tool';
+    commandTool?: string;
+    commandArgMode?: 'raw' | 'parsed';
+    [key: string]: unknown;
+}
+export interface InstallCommands {
+    darwin?: {
+        command: string;
+    };
+    linux?: {
+        command: string;
+    };
+    win32?: {
+        command: string;
+    };
+}
+export interface OpenClawMetadata {
+    emoji?: string;
+    homepage?: string;
+    primaryEnv?: string;
+    skillKey?: string;
+    always?: boolean;
+    os?: string[];
+    install?: InstallCommands;
+    requires?: {
+        bins?: string[];
+        anyBins?: string[];
+        env?: string[];
+        config?: string[];
+    };
+}
+/**
+ * Parse YAML frontmatter from a SKILL.md file.
+ * Returns empty frontmatter (no throw) if frontmatter block is missing.
+ */
+export declare function parseFrontmatter(content: string): {
+    frontmatter: ParsedFrontmatter;
+    body: string;
+};
+/**
+ * Extract OpenClaw-format metadata from the frontmatter metadata field.
+ * Checks for keys: clodds, openclaw, clawdbot
+ */
+export declare function resolveMetadata(frontmatter: ParsedFrontmatter): OpenClawMetadata | undefined;
+/**
+ * Merge Clodds-native gates with OpenClaw requires into a unified SkillGates.
+ */
+export declare function mergeGates(gates?: SkillGates, ocRequires?: OpenClawMetadata['requires']): SkillGates;