clodds 1.1.0

package/dist/commands/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Commands Service - Clawdbot-style slash commands
+ *
+ * Native commands that work across all channels:
+ * /new, /reset - Start fresh session
+ * /status - Check agent status and context usage
+ * /model - Show/change model
+ * /help - Show help
+ *
+ * Also supports:
+ * - Skill-based commands (from installed skills)
+ * - Per-command enable/disable configuration
+ * - Per-channel command overrides
+ */
+import { SessionManager } from '../sessions/index';
+import { Session, IncomingMessage } from '../types';
+import { SkillRegistry, InstalledSkill } from '../skills/index';
+export interface CommandResult {
+    handled: boolean;
+    response?: string;
+    action?: 'reset_session' | 'show_status' | 'show_help' | 'change_model' | 'skill_command';
+    /** If skill command, the skill that handled it */
+    skill?: string;
+}
+/** Command configuration */
+export interface CommandConfig {
+    /** Enable/disable specific commands */
+    enabled?: Record<string, boolean>;
+    /** Per-channel command overrides */
+    channelOverrides?: Record<string, Record<string, boolean>>;
+    /** Whether to register skill commands */
+    enableSkillCommands?: boolean;
+}
+export interface CommandsService {
+    /** Check if message is a command and handle it */
+    handleCommand(message: IncomingMessage, session: Session): Promise<CommandResult>;
+    /** Get list of available commands */
+    getCommands(): CommandInfo[];
+    /** Check if a command is enabled */
+    isEnabled(commandName: string, channel?: string): boolean;
+    /** Enable a command */
+    enable(commandName: string): void;
+    /** Disable a command */
+    disable(commandName: string): void;
+    /** Get all skill commands */
+    getSkillCommands(): CommandInfo[];
+    /** Register a skill's commands */
+    registerSkillCommands(skill: InstalledSkill): void;
+    /** Unregister a skill's commands */
+    unregisterSkillCommands(skillName: string): void;
+}
+export interface CommandInfo {
+    name: string;
+    description: string;
+    usage: string;
+    /** Whether this is a skill command */
+    isSkillCommand?: boolean;
+    /** The skill that provides this command */
+    skillName?: string;
+}
+export declare function createCommandsService(sessionManager: SessionManager, configInput?: CommandConfig, skillRegistry?: SkillRegistry): CommandsService;

package/dist/commands/index.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * Commands Service - Clawdbot-style slash commands
+ *
+ * Native commands that work across all channels:
+ * /new, /reset - Start fresh session
+ * /status - Check agent status and context usage
+ * /model - Show/change model
+ * /help - Show help
+ *
+ * Also supports:
+ * - Skill-based commands (from installed skills)
+ * - Per-command enable/disable configuration
+ * - Per-channel command overrides
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCommandsService = createCommandsService;
+const logger_1 = require("../utils/logger");
+const executor_1 = require("../skills/executor");
+const NATIVE_COMMANDS = [
+    { name: '/new', description: 'Start a fresh conversation', usage: '/new' },
+    { name: '/reset', description: 'Reset conversation history', usage: '/reset' },
+    { name: '/status', description: 'Show agent status and context usage', usage: '/status' },
+    { name: '/model', description: 'Show or change model', usage: '/model [sonnet|opus|haiku]' },
+    { name: '/help', description: 'Show available commands', usage: '/help' },
+    { name: '/context', description: 'Show context info', usage: '/context' },
+];
+/** Available models with shortcuts */
+const MODEL_ALIASES = {
+    'opus': 'claude-opus-4-6',
+    'opus4.6': 'claude-opus-4-6',
+    'opus4.5': 'claude-opus-4-5-20250514',
+    'sonnet': 'claude-sonnet-4-5-20250929',
+    'sonnet4.5': 'claude-sonnet-4-5-20250929',
+    'haiku': 'claude-haiku-4-5-20251001',
+    'haiku4.5': 'claude-haiku-4-5-20251001',
+    'claude-opus-4': 'claude-opus-4-6',
+    'claude-sonnet-4': 'claude-sonnet-4-5-20250929',
+    'claude-haiku-4': 'claude-haiku-4-5-20251001',
+};
+const DEFAULT_CONFIG = {
+    enabled: {},
+    channelOverrides: {},
+    enableSkillCommands: true,
+};
+function createCommandsService(sessionManager, configInput, skillRegistry) {
+    const config = { ...DEFAULT_CONFIG, ...configInput };
+    // Track enabled status
+    const enabledCommands = new Map();
+    // Initialize from config
+    if (config.enabled) {
+        for (const [cmd, enabled] of Object.entries(config.enabled)) {
+            enabledCommands.set(cmd, enabled);
+        }
+    }
+    // Track skill commands
+    const skillCommands = new Map();
+    // Load skill commands on startup
+    if (config.enableSkillCommands && skillRegistry) {
+        for (const skill of skillRegistry.listEnabled()) {
+            registerSkillCommandsInternal(skill);
+        }
+        // Listen for skill install/uninstall
+        skillRegistry.on('install', (skill) => {
+            registerSkillCommandsInternal(skill);
+        });
+        skillRegistry.on('uninstall', ({ name }) => {
+            skillCommands.delete(name);
+        });
+    }
+    function registerSkillCommandsInternal(skill) {
+        if (!skill.manifest.commands?.length)
+            return;
+        const commands = skill.manifest.commands.map(cmd => ({
+            name: cmd.name.startsWith('/') ? cmd.name : `/${cmd.name}`,
+            description: cmd.description,
+            usage: cmd.name.startsWith('/') ? cmd.name : `/${cmd.name}`,
+            isSkillCommand: true,
+            skillName: skill.manifest.name,
+        }));
+        skillCommands.set(skill.manifest.name, commands);
+        logger_1.logger.info({ skillName: skill.manifest.name, commands: commands.length }, 'Registered skill commands');
+    }
+    function isCommandEnabled(commandName, channel) {
+        // Check channel override first
+        if (channel && config.channelOverrides?.[channel]?.[commandName] !== undefined) {
+            return config.channelOverrides[channel][commandName];
+        }
+        // Check global setting
+        const globalSetting = enabledCommands.get(commandName);
+        if (globalSetting !== undefined) {
+            return globalSetting;
+        }
+        // Default to enabled
+        return true;
+    }
+    return {
+        async handleCommand(message, session) {
+            const text = message.text.trim();
+            // Check if it starts with /
+            if (!text.startsWith('/')) {
+                return { handled: false };
+            }
+            const [cmd, ...args] = text.split(/\s+/);
+            const command = cmd.toLowerCase();
+            // Check if command is enabled
+            if (!isCommandEnabled(command, message.platform)) {
+                logger_1.logger.debug({ command, channel: message.platform }, 'Command is disabled');
+                return { handled: false }; // Let agent handle as regular message
+            }
+            switch (command) {
+                case '/new':
+                case '/reset': {
+                    // Clear conversation history
+                    sessionManager.clearHistory(session);
+                    logger_1.logger.info({ sessionKey: session.key }, 'Session reset via command');
+                    return {
+                        handled: true,
+                        action: 'reset_session',
+                        response: `🔄 *Session Reset*\n\nConversation history cleared. Starting fresh!\n\nHow can I help you with prediction markets?`,
+                    };
+                }
+                case '/status': {
+                    const history = sessionManager.getHistory(session);
+                    const messageCount = history.length;
+                    // Estimate tokens (rough: ~4 chars per token)
+                    const totalChars = history.reduce((sum, m) => sum + m.content.length, 0);
+                    const estimatedTokens = Math.round(totalChars / 4);
+                    const uptime = Math.round((Date.now() - session.createdAt.getTime()) / 1000 / 60);
+                    return {
+                        handled: true,
+                        action: 'show_status',
+                        response: `📊 *Session Status*\n\n` +
+                            `*Session ID:* \`${session.id.slice(0, 8)}...\`\n` +
+                            `*Channel:* ${session.channel}\n` +
+                            `*Messages:* ${messageCount}\n` +
+                            `*Est. Tokens:* ~${estimatedTokens.toLocaleString()}\n` +
+                            `*Uptime:* ${uptime} minutes\n` +
+                            `*Created:* ${session.createdAt.toISOString().slice(0, 16).replace('T', ' ')}\n\n` +
+                            `Use \`/new\` to reset the conversation.`,
+                    };
+                }
+                case '/model': {
+                    const defaultModel = process.env.ANTHROPIC_MODEL || 'claude-opus-4-6';
+                    const currentModel = session.context.modelOverride || defaultModel;
+                    // If no argument, show current model
+                    if (args.length === 0) {
+                        const modelList = Object.keys(MODEL_ALIASES)
+                            .filter(k => !k.includes('-'))
+                            .map(k => `\`${k}\``)
+                            .join(', ');
+                        return {
+                            handled: true,
+                            action: 'change_model',
+                            response: `🤖 *Current Model*\n\n` +
+                                `\`${currentModel}\`\n` +
+                                (session.context.modelOverride ? `(session override)\n` : `(default)\n`) +
+                                `\n*Available:* ${modelList}\n` +
+                                `\n*Usage:* \`/model sonnet\` or \`/model opus\``,
+                        };
+                    }
+                    // Try to switch model
+                    const requestedModel = args[0].toLowerCase();
+                    const resolvedModel = MODEL_ALIASES[requestedModel] || requestedModel;
+                    // Validate it looks like a Claude model
+                    if (!resolvedModel.startsWith('claude-')) {
+                        return {
+                            handled: true,
+                            response: `❌ Unknown model: \`${requestedModel}\`\n\n` +
+                                `*Available:* sonnet, opus, haiku`,
+                        };
+                    }
+                    // Set model override in session
+                    session.context.modelOverride = resolvedModel;
+                    sessionManager.updateSession(session);
+                    logger_1.logger.info({ sessionKey: session.key, model: resolvedModel }, 'Model changed via command');
+                    return {
+                        handled: true,
+                        action: 'change_model',
+                        response: `✅ *Model Changed*\n\n` +
+                            `Now using: \`${resolvedModel}\`\n\n` +
+                            `Use \`/model\` to see current model or switch again.`,
+                    };
+                }
+                case '/context': {
+                    const history = sessionManager.getHistory(session);
+                    // Show last few messages
+                    const recent = history.slice(-5);
+                    const contextPreview = recent
+                        .map((m, i) => `${i + 1}. [${m.role}] ${m.content.slice(0, 50)}${m.content.length > 50 ? '...' : ''}`)
+                        .join('\n');
+                    return {
+                        handled: true,
+                        response: `📝 *Context Info*\n\n` +
+                            `*Total messages:* ${history.length}\n` +
+                            `*Max kept:* 20\n\n` +
+                            `*Recent messages:*\n${contextPreview || '(empty)'}`,
+                    };
+                }
+                case '/help': {
+                    const commandList = NATIVE_COMMANDS.map(c => `\`${c.name}\` - ${c.description}`).join('\n');
+                    return {
+                        handled: true,
+                        action: 'show_help',
+                        response: `🎲 *Clodds Commands*\n\n` +
+                            `*Native Commands:*\n${commandList}\n\n` +
+                            `*Tips:*\n` +
+                            `• Just chat naturally for most things\n` +
+                            `• Ask about any prediction market\n` +
+                            `• Set alerts, track portfolios, find edge\n\n` +
+                            `*Platforms:* Polymarket, Kalshi, Manifold, Metaculus, Drift`,
+                    };
+                }
+                default:
+                    // Try to execute as a skill command using the executor
+                    if (config.enableSkillCommands && (0, executor_1.isSkillCommand)(command)) {
+                        if (!isCommandEnabled(command, message.platform)) {
+                            logger_1.logger.debug({ command, channel: message.platform }, 'Skill command is disabled');
+                            return { handled: false };
+                        }
+                        // Execute the skill command
+                        const result = await (0, executor_1.executeSkillCommand)(text);
+                        if (result.handled) {
+                            logger_1.logger.info({ command, skill: result.skill }, 'Skill command executed');
+                            return {
+                                handled: true,
+                                action: 'skill_command',
+                                skill: result.skill,
+                                response: result.error
+                                    ? `❌ Error: ${result.error}`
+                                    : result.response || '(no response)',
+                            };
+                        }
+                    }
+                    // Check registered skill commands from registry (legacy path)
+                    if (config.enableSkillCommands) {
+                        for (const [skillName, commands] of skillCommands.entries()) {
+                            for (const cmd of commands) {
+                                if (cmd.name === command && isCommandEnabled(command, message.platform)) {
+                                    logger_1.logger.info({ command, skillName }, 'Skill command invoked (registry)');
+                                    return {
+                                        handled: true,
+                                        action: 'skill_command',
+                                        skill: skillName,
+                                        response: `🔧 Skill command \`${command}\` from *${skillName}* registered but no handler.`,
+                                    };
+                                }
+                            }
+                        }
+                    }
+                    // Unknown command - don't handle, let agent process it
+                    return { handled: false };
+            }
+        },
+        getCommands() {
+            const allCommands = [...NATIVE_COMMANDS];
+            // Add skill commands
+            for (const commands of skillCommands.values()) {
+                allCommands.push(...commands);
+            }
+            return allCommands;
+        },
+        isEnabled(commandName, channel) {
+            return isCommandEnabled(commandName, channel);
+        },
+        enable(commandName) {
+            enabledCommands.set(commandName, true);
+            logger_1.logger.info({ commandName }, 'Command enabled');
+        },
+        disable(commandName) {
+            enabledCommands.set(commandName, false);
+            logger_1.logger.info({ commandName }, 'Command disabled');
+        },
+        getSkillCommands() {
+            const commands = [];
+            for (const cmds of skillCommands.values()) {
+                commands.push(...cmds);
+            }
+            return commands;
+        },
+        registerSkillCommands(skill) {
+            registerSkillCommandsInternal(skill);
+        },
+        unregisterSkillCommands(skillName) {
+            skillCommands.delete(skillName);
+            logger_1.logger.info({ skillName }, 'Unregistered skill commands');
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

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

package/dist/commands/registry.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Slash Command Registry - shared command registration and handling
+ *
+ * Provides a single source of truth for commands across channels and
+ * supports platform-level registration (e.g., Telegram setMyCommands).
+ */
+import type { IncomingMessage, OutgoingMessage, Session } from '../types';
+import type { SessionManager } from '../sessions/index';
+import type { FeedManager } from '../feeds/index';
+import type { Database } from '../db/index';
+import type { MemoryService } from '../memory/index';
+import type { OpportunityFinder } from '../opportunity/index';
+export interface CommandContext {
+    session: Session;
+    message: IncomingMessage;
+    sessions: SessionManager;
+    feeds: FeedManager;
+    db: Database;
+    memory?: MemoryService;
+    opportunityFinder?: OpportunityFinder;
+    bittensorService?: import('../bittensor/types').BittensorService;
+    commands: CommandRegistry;
+    send: (message: OutgoingMessage) => Promise<string | null>;
+}
+export interface CommandDefinition {
+    /** Command name without leading slash, e.g. "help" */
+    name: string;
+    /** Short human-readable description */
+    description: string;
+    /** Usage string including slash */
+    usage: string;
+    /** Optional aliases without leading slash */
+    aliases?: string[];
+    /** Whether this should be registered with platform UIs */
+    register?: boolean;
+    /** Handle a command invocation */
+    handler: (args: string, ctx: CommandContext) => Promise<string> | string;
+}
+export interface CommandInfo {
+    name: string;
+    description: string;
+    usage: string;
+    register: boolean;
+}
+export interface CommandListEntry {
+    name: string;
+    description: string;
+    category: string;
+    subcommands?: Array<{
+        name: string;
+        description: string;
+        category: string;
+    }>;
+}
+/** Category mapping — string for single category, string[] for multi-category commands */
+export declare const COMMAND_CATEGORIES: Record<string, string | string[]>;
+export interface CommandRegistry {
+    register(command: CommandDefinition): void;
+    registerMany(commands: CommandDefinition[]): void;
+    list(): CommandInfo[];
+    /** Return all commands with category labels for UI display */
+    listAll(): CommandListEntry[];
+    /**
+     * Handle a command message. Returns null when not handled.
+     */
+    handle(message: IncomingMessage, ctx: Omit<CommandContext, 'message' | 'commands'>): Promise<string | null>;
+}
+export declare function createCommandRegistry(): CommandRegistry;
+export declare function createDefaultCommands(): CommandDefinition[];