twinclaw 1.3.1 → 1.4.0

package/dist/core/logs-cli.js

@@ -1,20 +1,21 @@
 import * as fs from 'node:fs';
 import * as fsPromises from 'node:fs/promises';
 import path from 'node:path';
+import { getWorkspaceDir } from '../config/workspace.js';
 function currentDateIso() {
     return new Date().toISOString().slice(0, 10);
 }
 function printLogsUsage() {
-    console.log(`Logs commands:
-  twinclaw logs                    View today's logs
-  twinclaw logs --follow           Follow logs in real-time
-  twinclaw logs --follow -f        Same as above (shorthand)
-  twinclaw logs --date <YYYY-MM-DD> View logs for specific date
-
-Examples:
-  twinclaw logs
-  twinclaw logs --follow
-  twinclaw logs -f
+    console.log(`Logs commands:
+  twinclaw logs                    View today's logs
+  twinclaw logs --follow           Follow logs in real-time
+  twinclaw logs --follow -f        Same as above (shorthand)
+  twinclaw logs --date <YYYY-MM-DD> View logs for specific date
+
+Examples:
+  twinclaw logs
+  twinclaw logs --follow
+  twinclaw logs -f
   twinclaw logs --date 2026-02-20`);
 }
 /**
@@ -36,7 +37,7 @@ export async function handleLogsCli(argv) {
     if (dateIndex !== -1 && argv[dateIndex + 1]) {
         dateIso = argv[dateIndex + 1];
     }
-    const logPath = path.resolve('memory', `${dateIso}.md`);
+    const logPath = path.join(getWorkspaceDir(), 'memory', `${dateIso}.md`);
     if (!fs.existsSync(logPath)) {
         console.error(`[TwinClaw Logs] No logs found for today (${dateIso}) at ${logPath}.`);
         process.exitCode = 1;

package/dist/core/onboarding.js

@@ -32,246 +32,14 @@ const REPL_COMMANDS = [
     { cmd: '/clear', desc: 'Clear conversation' },
     { cmd: '/quit', desc: 'Exit chat mode' },
 ];
-function showReplHelp() {
-    console.log('\n╔═══════════════════════════════════════════╗');
-    console.log('║         TwinClaw Chat Commands            ║');
-    console.log('╠═══════════════════════════════════════════╣');
-    for (const c of REPL_COMMANDS) {
-        console.log(`║ ${c.cmd.padEnd(35)} ║`);
-        console.log(`║   ${c.desc.padEnd(33)} ║`);
-        console.log('║                                          ║');
-    }
-    console.log('╚═══════════════════════════════════════════╝\n');
-}
-async function showConfigStatus() {
-    try {
-        const { readConfig } = await import('../config/json-config.js');
-        const config = await readConfig();
-        console.log('\n╔═══════════════════════════════════════════╗');
-        console.log('║         Current Configuration            ║');
-        console.log('╠═══════════════════════════════════════════╣');
-        console.log(`║ Runtime                                      ║`);
-        console.log(`║   API Port: ${config.runtime.apiPort}                        ║`);
-        console.log(`║                                              ║`);
-        console.log(`║ Models                                       ║`);
-        console.log(`║   Primary: ${(config.models.primaryModel || 'not set').padEnd(25)} ║`);
-        if (config.models.definitions?.length) {
-            console.log(`║   Defined: ${config.models.definitions.length} models                         ║`);
-        }
-        console.log(`║                                              ║`);
-        console.log(`║ API Keys                                     ║`);
-        console.log(`║   Modal: ${config.models.modalApiKey ? '***set***' : 'not set'.padEnd(22)} ║`);
-        console.log(`║   OpenRouter: ${config.models.openRouterApiKey ? '***set***' : 'not set'.padEnd(17)} ║`);
-        console.log(`║   Gemini: ${config.models.geminiApiKey ? '***set***' : 'not set'.padEnd(21)} ║`);
-        console.log(`║   Groq: ${config.messaging.voice.groqApiKey ? '***set***' : 'not set'.padEnd(24)} ║`);
-        console.log(`║   GitHub: ${config.models.githubToken ? '***set***' : 'not set'.padEnd(21)} ║`);
-        console.log(`║                                              ║`);
-        console.log(`║ Channels                                     ║`);
-        console.log(`║   Telegram: ${config.messaging.telegram.enabled ? 'enabled' : 'disabled'.padEnd(19)} ║`);
-        console.log(`║   WhatsApp: ${config.messaging.whatsapp.enabled ? 'enabled' : 'disabled'.padEnd(18)} ║`);
-        console.log('╚═══════════════════════════════════════════╝\n');
-    }
-    catch (err) {
-        console.log('Error loading config:', err);
-    }
-}
-async function showModelStatus() {
-    try {
-        const { readConfig } = await import('../config/json-config.js');
-        const config = await readConfig();
-        console.log('\n--- Models ---');
-        console.log(`Primary: ${config.models.primaryModel || 'not set'}`);
-        if (config.models.definitions?.length) {
-            console.log('\nConfigured Models:');
-            for (const def of config.models.definitions) {
-                const isPrimary = def.model === config.models.primaryModel ? ' *' : '';
-                console.log(`  - ${def.provider}/${def.model}${isPrimary}`);
-            }
-        }
-        console.log('\nTo change: /model set <provider/model>');
-        console.log('-----------\n');
-    }
-    catch (err) {
-        console.log('Error:', err);
-    }
-}
-async function setModel(modelArg) {
-    if (!modelArg) {
-        console.log('\nUsage: /model set <provider/model>');
-        console.log('\nValid providers: modal, groq, openrouter, google, github');
-        console.log('\nExamples:');
-        console.log('  /model set modal          (your custom model)');
-        console.log('  /model set groq/qwen/qwen3-32b');
-        console.log('  /model set openrouter/meta-llama/llama-3.3-70b-instruct');
-        console.log('  /model set google/gemini-2.0-flash');
-        return;
-    }
-    // Validate the model format
-    const validProviders = ['modal', 'groq', 'openrouter', 'google', 'github', 'anthropic'];
-    const modelLower = modelArg.toLowerCase();
-    // Check if it follows provider/model format
-    if (!modelLower.includes('/')) {
-        console.log('\n⚠️ Invalid format. Use: provider/model');
-        console.log('Example: /model set modal');
-        console.log('Valid providers: modal, groq, openrouter, google, github');
-        return;
-    }
-    const [provider] = modelLower.split('/');
-    if (!validProviders.includes(provider)) {
-        console.log(`\n⚠️ Unknown provider: ${provider}`);
-        console.log('Valid providers: modal, groq, openrouter, google, github');
-        return;
-    }
-    try {
-        const { readConfig, writeConfig } = await import('../config/json-config.js');
-        const config = await readConfig();
-        config.models.primaryModel = modelArg;
-        await writeConfig(config);
-        console.log(`\n✅ Primary model set to: ${modelArg}\n`);
-        console.log('Note: Restart gateway for changes to take effect.');
-    }
-    catch (err) {
-        console.log('Error setting model:', err);
-    }
-}
-async function setApiKey(provider, key) {
-    if (!provider || !key) {
-        console.log('\nUsage: /key set <provider> <api-key>');
-        console.log('\nProviders: modal, openrouter, gemini, groq, github');
-        console.log('\nExample: /key set modal sk-xxxxx');
-        return;
-    }
-    try {
-        const { readConfig, writeConfig } = await import('../config/json-config.js');
-        const config = await readConfig();
-        const keyLower = provider.toLowerCase();
-        if (keyLower === 'modal')
-            config.models.modalApiKey = key;
-        else if (keyLower === 'openrouter')
-            config.models.openRouterApiKey = key;
-        else if (keyLower === 'gemini')
-            config.models.geminiApiKey = key;
-        else if (keyLower === 'groq')
-            config.messaging.voice.groqApiKey = key;
-        else if (keyLower === 'github')
-            config.models.githubToken = key;
-        else {
-            console.log(`Unknown provider: ${provider}`);
-            console.log('Valid providers: modal, openrouter, gemini, groq, github');
-            return;
-        }
-        await writeConfig(config);
-        console.log(`\n✅ ${provider} API key updated\n`);
-    }
-    catch (err) {
-        console.log('Error setting key:', err);
-    }
-}
-async function showChannelStatus() {
-    try {
-        const { readConfig } = await import('../config/json-config.js');
-        const config = await readConfig();
-        console.log('\n--- Messaging Channels ---');
-        console.log(`Telegram: ${config.messaging.telegram.enabled ? 'enabled' : 'disabled'}`);
-        if (config.messaging.telegram.enabled) {
-            console.log(`  Bot Token: ${config.messaging.telegram.botToken ? '***set***' : 'not set'}`);
-            console.log(`  User ID: ${config.messaging.telegram.userId || 'not set'}`);
-            console.log(`  Allow From: ${config.messaging.telegram.allowFrom.join(', ') || 'none'}`);
-        }
-        console.log(`\nWhatsApp: ${config.messaging.whatsapp.enabled ? 'enabled' : 'disabled'}`);
-        if (config.messaging.whatsapp.enabled) {
-            console.log(`  Phone: ${config.messaging.whatsapp.phoneNumber || 'not set'}`);
-            console.log(`  Allow From: ${config.messaging.whatsapp.allowFrom.join(', ') || 'none'}`);
-        }
-        console.log('\nTo configure: twinclaw channels');
-        console.log('--------------\n');
-    }
-    catch (err) {
-        console.log('Error:', err);
-    }
-}
-function handleReplCommand(line, gateway, sessionId) {
-    const parts = line.trim().split(/\s+/);
-    const cmd = parts[0].toLowerCase();
-    const args = parts.slice(1).join(' ');
-    switch (cmd) {
-        case '/help':
-            showReplHelp();
-            return true;
-        case '/status':
-            console.log('\n--- Gateway Status ---');
-            console.log('Status: Running ✅');
-            console.log('Session:', sessionId);
-            console.log('----------------------\n');
-            return true;
-        case '/models':
-        case '/model':
-            if (args.startsWith('set ')) {
-                setModel(args.substring(4).trim());
-            }
-            else if (args === 'list') {
-                console.log('\n--- Model Catalog ---');
-                console.log('Use twinclaw config model to view full catalog');
-                console.log('--------------------\n');
-            }
-            else {
-                showModelStatus();
-            }
-            return true;
-        case '/keys':
-        case '/key':
-            if (args.startsWith('set ')) {
-                const keyParts = args.substring(4).trim().split(/\s+/);
-                if (keyParts.length >= 2) {
-                    setApiKey(keyParts[0], keyParts.slice(1).join(' '));
-                }
-                else {
-                    console.log('\nUsage: /key set <provider> <api-key>\n');
-                }
-            }
-            else {
-                showConfigStatus();
-            }
-            return true;
-        case '/channel':
-        case '/channels':
-            showChannelStatus();
-            return true;
-        case '/persona':
-            console.log('\nTo view/edit persona, use: twinclaw persona');
-            console.log('To edit in chat: /persona edit <soul|identity|user> <text>');
-            console.log('--------------\n');
-            return true;
-        case '/doctor':
-            console.log('\nRunning diagnostics...\n');
-            console.log('Use: twinclaw doctor');
-            console.log('------\n');
-            return true;
-        case '/config':
-            console.log('\n--- Configuration Menu ---');
-            console.log('Commands:');
-            console.log('  /config show     - Show full config');
-            console.log('  /config edit    - Open interactive editor');
-            console.log('  /model set <id> - Change primary model');
-            console.log('  /key set <prov> <key> - Set API key');
-            console.log('------------------------\n');
-            return true;
-        case '/clear':
-            console.log('\nConversation cleared.\n');
-            return true;
-        case '/quit':
-            console.log('\nExiting chat mode. Use Ctrl+C to exit.\n');
-            return true;
-        default:
-            return false;
-    }
-}
+import { CommandRouter } from './command-router.js';
 export function startBasicREPL(gateway) {
     console.log('TwinClaw basic REPL started.');
     console.log('Type /help for available commands.\n');
     void logThought('Basic REPL started.');
     const sessionId = 'default_repl';
     createSession(sessionId);
+    const router = new CommandRouter(gateway);
     rl.on('line', async (line) => {
         if (!line.trim())
             return;
@@ -279,9 +47,9 @@ export function startBasicREPL(gateway) {
         try {
             // Handle / commands
             if (line.trim().startsWith('/')) {
-                if (handleReplCommand(line, gateway, sessionId)) {
-                    return;
-                }
+                const response = await router.dispatch(line.trim(), 'repl', sessionId);
+                console.log(response);
+                return;
             }
             const responseText = await gateway.processText(sessionId, line);
             console.log(`\nTwinClaw: ${responseText}\n`);
@@ -622,7 +390,7 @@ function inferPrimaryModel(config) {
         return 'google/gemini-flash-lite-latest';
     }
     if (hasValue(config.models.modalApiKey)) {
-        return 'modal/zai-org/GLM-5-FP8';
+        return 'modal-zai-glm-5-fp8';
     }
     return null;
 }

package/dist/core/queue-cli.js

@@ -1,6 +1,6 @@
 import * as fs from 'node:fs';
-import * as path from 'node:path';
 import { readQueueStateCounts } from './queue-metrics.js';
+import { getDatabasePath } from '../config/workspace.js';
 function printQueueUsage() {
     console.log(`Queue commands:
   twinclaw queue status        Show message queue status
@@ -16,7 +16,7 @@ Examples:
   twinclaw queue retry 550e8400-e29b-41d4-a716-446655440000`);
 }
 function getDbPath() {
-    return path.resolve('memory', 'twinclaw.db');
+    return getDatabasePath();
 }
 function queryDb(sql) {
     const dbPath = getDbPath();

package/dist/core/status-cli.js

@@ -1,8 +1,8 @@
 import { readConfig } from '../config/json-config.js';
 import { runDoctorChecks, BINARY_CHECKS, CONFIG_CHECKS, CHANNEL_CHECKS } from './doctor.js';
 import { execSync } from 'child_process';
-import * as path from 'node:path';
 import { readQueueStateCounts } from './queue-metrics.js';
+import { getDatabasePath } from '../config/workspace.js';
 export function getGatewayStatus() {
     try {
         const result = execSync('sc query "TwinClaw Gateway"', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
@@ -23,7 +23,7 @@ export function getGatewayStatus() {
     }
 }
 export function getQueueStatus() {
-    const counts = readQueueStateCounts(path.resolve('memory', 'twinclaw.db'));
+    const counts = readQueueStateCounts(getDatabasePath());
     return {
         pending: counts.queued,
         failed: counts.failed,

package/dist/interfaces/telegram_handler.js

@@ -1,24 +1,9 @@
 import TelegramBot from 'node-telegram-bot-api';
 import os from 'node:os';
 import path from 'node:path';
-import { readConfig, writeConfig } from '../config/json-config.js';
-import { getModelCatalogService } from '../services/model-catalog-service.js';
 /** Minimum ms delay between processing successive messages (human-like pacing). */
 const RATE_LIMIT_MS = 1500;
-const TELEGRAM_COMMANDS = [
-    { cmd: '/start', desc: 'Show welcome message and menu' },
-    { cmd: '/help', desc: 'Show all available commands' },
-    { cmd: '/status', desc: 'Show gateway status' },
-    { cmd: '/menu', desc: 'Show this menu' },
-    { cmd: '/models', desc: 'Show configured models' },
-    { cmd: '/model set', desc: 'Set primary model' },
-    { cmd: '/keys', desc: 'Show API keys status' },
-    { cmd: '/key set', desc: 'Set API key' },
-    { cmd: '/channel', desc: 'Show channel status' },
-    { cmd: '/persona', desc: 'Show persona' },
-    { cmd: '/doctor', desc: 'Run diagnostics' },
-    { cmd: '/clear', desc: 'Clear conversation' },
-];
+import { CommandRouter } from '../core/command-router.js';
 /**
  * Wraps the Telegram Bot API to provide:
  *   - Inbound message normalization for the dispatcher
@@ -94,179 +79,10 @@ export class TelegramHandler {
             console.error('[TelegramHandler] Polling error:', err.message);
         });
     }
-    // ── Command Handlers ─────────────────────────────────────────────────────────
     async handleCommand(chatId, command) {
-        const parts = command.toLowerCase().trim().split(/\s+/);
-        const cmd = parts[0];
-        const args = parts.slice(1).join(' ');
-        switch (cmd) {
-            case '/start':
-            case '/menu':
-                const menuText = `🎯 *TwinClaw Menu*
-        
-${TELEGRAM_COMMANDS.map(c => `${c.cmd} - ${c.desc}`).join('\n')}
-
-_How can I help you today?_
-`;
-                await this.#bot.sendMessage(chatId, menuText, { parse_mode: 'Markdown' });
-                break;
-            case '/help':
-                await this.#bot.sendMessage(chatId, `📋 *Available Commands:*
-
-${TELEGRAM_COMMANDS.map(c => `${c.cmd} - ${c.desc}`).join('\n')}
-
-_Just send me a message and I'll respond!_
-`, { parse_mode: 'Markdown' });
-                break;
-            case '/status':
-                await this.#bot.sendMessage(chatId, `✅ *Gateway Status:*
-
-• Status: Running
-• Platform: Telegram
-• Mode: AI Assistant
-
-_All systems operational_
-`, { parse_mode: 'Markdown' });
-                break;
-            case '/models':
-            case '/model':
-                if (args.startsWith('list')) {
-                    const catalog = getModelCatalogService().getAllModels();
-                    const config = await readConfig();
-                    const currentPrimary = config.models.primaryModel || 'not set';
-                    let modelList = `📦 *Available Models*\n\nCurrent: *${currentPrimary}*\n\n`;
-                    const providerGroups = new Map();
-                    for (const model of catalog) {
-                        const models = providerGroups.get(model.provider) || [];
-                        models.push(model);
-                        providerGroups.set(model.provider, models);
-                    }
-                    let num = 1;
-                    for (const [provider, models] of providerGroups) {
-                        modelList += `*${provider.toUpperCase()}:*\n`;
-                        for (const m of models.slice(0, 5)) {
-                            const isCurrent = m.model === currentPrimary || m.id === currentPrimary;
-                            modelList += `${num}. ${m.name}${isCurrent ? ' ✅' : ''}\n`;
-                            num++;
-                        }
-                        if (models.length > 5)
-                            modelList += `  ...and ${models.length - 5} more\n`;
-                        modelList += '\n';
-                    }
-                    modelList += '_To switch: /model set <number>_';
-                    await this.#bot.sendMessage(chatId, modelList, { parse_mode: 'Markdown' });
-                }
-                else if (args.startsWith('set ') && args.length > 4) {
-                    const modelIdOrNum = args.substring(4).trim();
-                    const catalog = getModelCatalogService().getAllModels();
-                    let newModelId = modelIdOrNum;
-                    if (/^\d+$/.test(modelIdOrNum)) {
-                        const idx = parseInt(modelIdOrNum, 10) - 1;
-                        if (idx >= 0 && idx < catalog.length) {
-                            newModelId = `${catalog[idx].provider}/${catalog[idx].model}`;
-                        }
-                        else {
-                            await this.#bot.sendMessage(chatId, `❌ Invalid model number. Use /model list to see available models.`);
-                            break;
-                        }
-                    }
-                    const config = await readConfig();
-                    config.models.primaryModel = newModelId;
-                    await writeConfig(config);
-                    await this.#bot.sendMessage(chatId, `✅ *Model updated!*\n\nNew primary model: *${newModelId}*\n\nRestart TwinClaw for changes to take effect.`, { parse_mode: 'Markdown' });
-                }
-                else {
-                    const config = await readConfig();
-                    const currentPrimary = config.models.primaryModel || 'not set';
-                    await this.#bot.sendMessage(chatId, `📦 *Models*
-
-Current: *${currentPrimary}*
-
-Commands:
-• /model list - List available models
-• /model set <number> - Set primary model
-
-Example: /model set 1
-`, { parse_mode: 'Markdown' });
-                }
-                break;
-            case '/keys':
-            case '/key':
-                if (args.startsWith('set ') && args.length > 4) {
-                    const keyParts = args.substring(4).trim().split(/\s+/);
-                    if (keyParts.length >= 2) {
-                        const provider = keyParts[0];
-                        const key = keyParts.slice(1).join(' ');
-                        await this.#bot.sendMessage(chatId, `🔐 To set *${provider}* API key, run:\n\n\`twinclaw secret set ${provider.toUpperCase()}_API_KEY ${key}\`\n\n_Or use: twinclaw config edit_
-`, { parse_mode: 'Markdown' });
-                    }
-                    else {
-                        await this.#bot.sendMessage(chatId, `Usage: /key set <provider> <api-key>\n\nExample: /key set modal sk-xxxxx`);
-                    }
-                }
-                else {
-                    await this.#bot.sendMessage(chatId, `🔑 *API Keys*
-
-Use *twinclaw config* to manage API keys.
-
-Commands:
-• /keys show - Show key status
-• /key set <provider> <key> - Set API key
-
-_Or run: twinclaw config_
-`, { parse_mode: 'Markdown' });
-                }
-                break;
-            case '/channel':
-            case '/channels':
-                await this.#bot.sendMessage(chatId, `📱 *Channels*
-
-Telegram: ✅ Connected
-WhatsApp: Use /channels to configure
-
-Run: *twinclaw channels* to manage
-`, { parse_mode: 'Markdown' });
-                break;
-            case '/persona':
-                await this.#bot.sendMessage(chatId, `👤 *Persona*
-
-Run: *twinclaw persona* to view/edit
-
-Commands:
-• twinclaw persona show - View persona
-• twinclaw persona edit soul "text" - Edit soul
-`, { parse_mode: 'Markdown' });
-                break;
-            case '/doctor':
-                await this.#bot.sendMessage(chatId, `🩺 *Diagnostics*
-
-Run: *twinclaw doctor* to check system health
-
-Checks:
-• Environment variables
-• API keys
-• Configuration
-• Channels
-`, { parse_mode: 'Markdown' });
-                break;
-            case '/config':
-                await this.#bot.sendMessage(chatId, `⚙️ *Configuration*
-
-Use: *twinclaw config* to:
-• Edit configuration
-• Set API keys
-• Change models
-• Manage channels
-
-Run: *twinclaw config* in terminal
-`, { parse_mode: 'Markdown' });
-                break;
-            case '/clear':
-                await this.#bot.sendMessage(chatId, '🗑️ Conversation cleared! Starting fresh.');
-                break;
-            default:
-                await this.#bot.sendMessage(chatId, `Unknown command: ${command}\nType /menu for available commands.`);
-        }
+        const router = new CommandRouter();
+        const response = await router.dispatch(command, 'telegram', String(chatId));
+        await this.#bot.sendMessage(chatId, response, { parse_mode: 'Markdown' });
     }
     // ── Public Send Methods ───────────────────────────────────────────────────────
     /** Send a plain-text reply to a chat. */