twinclaw 1.3.1 → 1.4.0

package/dist/api/handlers/browser.js

@@ -1,6 +1,7 @@
 import { BrowserReferenceError } from '../../services/browser-service.js';
 import { sendOk, sendError, mapError } from '../shared.js';
 import { logThought } from '../../utils/logger.js';
+import { getWorkspaceDir } from '../../config/workspace.js';
 import path from 'node:path';
 import { isIP } from 'node:net';
 import { unlink } from 'node:fs/promises';
@@ -150,7 +151,7 @@ export function handleBrowserSnapshot(deps) {
                 await deps.browserService.navigate(validatedUrl.url);
                 await logThought(`[API] Browser navigated to: ${validatedUrl.url}`);
             }
-            const screenshotPath = path.resolve('memory', `snapshot_${Date.now()}.png`);
+            const screenshotPath = path.join(getWorkspaceDir(), 'memory', `snapshot_${Date.now()}.png`);
             const fullPage = body.fullPage !== false;
             const result = await deps.browserService.takeScreenshotForVlm(screenshotPath, fullPage);
             const tree = await deps.browserService.getAccessibilityTree();

package/dist/api/handlers/debug.js

@@ -2,6 +2,7 @@ import { sendOk, sendError } from '../shared.js';
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 import os from 'node:os';
+import { getWorkspaceDir } from '../../config/workspace.js';
 /** GET /debug — Extended diagnostics including full context budget, recent logs, active connections, performance metrics */
 export function handleDebug(deps) {
     return async (req, res) => {
@@ -46,7 +47,7 @@ export function handleDebug(deps) {
 }
 async function getRecentLogs(limit) {
     const dateIso = new Date().toISOString().slice(0, 10);
-    const logPath = path.resolve('memory', `${dateIso}.md`);
+    const logPath = path.join(getWorkspaceDir(), 'memory', `${dateIso}.md`);
     let content = '';
     try {
         content = await readFile(logPath, 'utf8');

package/dist/api/router.js

@@ -16,6 +16,7 @@ import { logThought } from '../utils/logger.js';
 import { getCallbackOutcomeCounts } from '../services/db-incidents.js';
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
+import { getWorkspaceDir } from '../config/workspace.js';
 import { getConfigValue } from '../config/json-config.js';
 import { getDevicePairingService } from '../services/device-pairing.js';
 import { registerSelfRoutes } from './handlers/self-routes.js';
@@ -225,7 +226,7 @@ export function startApiServer(deps) {
     app.get('/logs', async (_req, res) => {
         try {
             const dateIso = new Date().toISOString().slice(0, 10);
-            const logPath = path.resolve('memory', `${dateIso}.md`);
+            const logPath = path.join(getWorkspaceDir(), 'memory', `${dateIso}.md`);
             let content = '';
             try {
                 content = await readFile(logPath, 'utf8');

package/dist/config/json-config.js

@@ -315,9 +315,9 @@ export const MODEL_PROVIDERS = [
     { id: 'vllm', name: 'vLLM', baseUrl: 'http://localhost:8000/v1', defaultModel: 'meta-llama/Llama-3.1-70B-Instruct', supportsStreaming: true, supportsFunctionCalling: true, contextWindow: 128000 },
     { id: 'minimax', name: 'MiniMax', baseUrl: 'https://api.minimax.chat/v1', defaultModel: 'abab6.5s-chat', supportsStreaming: true, contextWindow: 245760 },
     { id: 'moonshot', name: 'Moonshot AI (Kimi K2.5)', baseUrl: 'https://api.moonshot.cn/v1', defaultModel: 'moonshot-v1-8k', supportsStreaming: true, contextWindow: 128000 },
-    { id: 'google', name: 'Google', baseUrl: 'https://generativelanguage.googleapis.com/v1', defaultModel: 'gemini-2.0-flash-exp', supportsStreaming: true, contextWindow: 1000000 },
+    { id: 'google', name: 'Google', baseUrl: 'https://generativelanguage.googleapis.com/v1beta/openai/chat/completions', defaultModel: 'gemini-2.0-flash-exp', supportsStreaming: true, contextWindow: 1000000 },
     { id: 'xai', name: 'xAI (Grok)', baseUrl: 'https://api.x.ai/v1', defaultModel: 'grok-2-1212', supportsStreaming: true, contextWindow: 131072 },
-    { id: 'openrouter', name: 'OpenRouter', baseUrl: 'https://openrouter.ai/api/v1', defaultModel: 'anthropic/claude-sonnet-4-20250514', supportsStreaming: true, supportsFunctionCalling: true, contextWindow: 200000 },
+    { id: 'openrouter', name: 'OpenRouter', baseUrl: 'https://openrouter.ai/api/v1/chat/completions', defaultModel: 'anthropic/claude-sonnet-4-20250514', supportsStreaming: true, supportsFunctionCalling: true, contextWindow: 200000 },
     { id: 'qwen', name: 'Qwen', baseUrl: 'https://dashscope.aliyuncs.com/compatible-mode/v1', defaultModel: 'qwen-plus', supportsStreaming: true, contextWindow: 131072 },
     { id: 'zai', name: 'Z.AI', baseUrl: 'https://api.zai.net/v1', defaultModel: 'zai/llama-3.3-70b-instruct', supportsStreaming: true, contextWindow: 128000 },
     { id: 'qianfan', name: 'Qianfan', baseUrl: 'https://qianfan.baidubce.com/v3', defaultModel: 'ernie-4.0-8k', supportsStreaming: true, contextWindow: 32000 },
@@ -331,7 +331,8 @@ export const MODEL_PROVIDERS = [
     { id: 'venice', name: 'Venice AI', baseUrl: 'https://api.venice.ai/api/v1', defaultModel: 'qwen2.5-72b', supportsStreaming: true, contextWindow: 131072 },
     { id: 'litellm', name: 'LiteLLM', baseUrl: '', defaultModel: '', supportsStreaming: true },
     { id: 'cloudflare', name: 'Cloudflare AI Gateway', baseUrl: '', defaultModel: '@cf/meta/llama-3.1-70b-instruct', supportsStreaming: false, contextWindow: 128000 },
-    { id: 'modal', name: 'Modal', baseUrl: 'https://api.us-west-2.modal.direct/v1', defaultModel: 'zai-org/GLM-5-FP8', supportsStreaming: true, contextWindow: 200000 },
+    { id: 'modal', name: 'Modal', baseUrl: 'https://api.us-west-2.modal.direct/v1/chat/completions', defaultModel: 'zai-org/GLM-5-FP8', supportsStreaming: true, contextWindow: 200000 },
+    { id: 'groq', name: 'Groq', baseUrl: 'https://api.groq.com/openai/v1/chat/completions', defaultModel: 'llama-3.3-70b-versatile', supportsStreaming: true, contextWindow: 131072 },
     { id: 'custom', name: 'Custom Provider', baseUrl: '', defaultModel: '', supportsStreaming: true },
 ];
 export const DEFAULT_CONFIG = {

package/dist/config/model-catalog.js

@@ -372,31 +372,31 @@ export const PROVIDER_INFO = {
     },
     openrouter: {
         name: 'OpenRouter',
-        baseURL: 'https://openrouter.ai/api/v1',
+        baseURL: 'https://openrouter.ai/api/v1/chat/completions',
         apiKeyEnvName: 'OPENROUTER_API_KEY',
         supportsVision: true
     },
     modal: {
         name: 'Modal',
-        baseURL: 'https://api.us-west-2.modal.direct/v1',
+        baseURL: 'https://api.us-west-2.modal.direct/v1/chat/completions',
         apiKeyEnvName: 'MODAL_API_KEY',
         supportsVision: false
     },
     groq: {
         name: 'Groq',
-        baseURL: 'https://api.groq.com/openai/v1',
+        baseURL: 'https://api.groq.com/openai/v1/chat/completions',
         apiKeyEnvName: 'GROQ_API_KEY',
         supportsVision: false
     },
     github: {
         name: 'GitHub Copilot',
-        baseURL: 'https://api.githubcopilot.com',
+        baseURL: 'https://api.githubcopilot.com/chat/completions',
         apiKeyEnvName: 'GITHUB_TOKEN',
         supportsVision: true
     },
     copilot: {
         name: 'GitHub Copilot',
-        baseURL: 'https://api.githubcopilot.com',
+        baseURL: 'https://api.githubcopilot.com/chat/completions',
         apiKeyEnvName: 'GITHUB_TOKEN',
         supportsVision: true
     }

package/dist/core/channels-cli.js

@@ -1,5 +1,7 @@
 import WAWebJS from 'whatsapp-web.js';
 import qrcode from 'qrcode-terminal';
+import path from 'node:path';
+import { getWorkspaceDir } from '../config/workspace.js';
 import { readConfig, writeConfig } from '../config/json-config.js';
 const { Client, LocalAuth } = WAWebJS;
 function printUsage() {
@@ -69,7 +71,7 @@ async function runWhatsappLogin() {
     console.log('Initializing secure browser environment...');
     const disableChromiumSandbox = process.env.WHATSAPP_DISABLE_CHROMIUM_SANDBOX === 'true';
     const clientConfig = {
-        authStrategy: new LocalAuth({ dataPath: './memory/whatsapp_auth' }),
+        authStrategy: new LocalAuth({ dataPath: path.join(getWorkspaceDir(), 'memory', 'whatsapp_auth') }),
     };
     if (disableChromiumSandbox) {
         clientConfig.puppeteer = {

package/dist/core/chat-commands.js

@@ -0,0 +1,198 @@
+import { readConfig, writeConfig } from '../config/json-config.js';
+import { getModelCatalogService } from '../services/model-catalog-service.js';
+export const CHAT_COMMANDS = [
+    { cmd: '/help', desc: 'Show all commands' },
+    { cmd: '/status', desc: 'Show gateway status' },
+    { cmd: '/models', desc: 'Show configured models' },
+    { cmd: '/model list', desc: 'List available models in catalog' },
+    { cmd: '/model set <name>', desc: 'Set primary model (e.g., /model set modal)' },
+    { cmd: '/keys', desc: 'Show API keys status' },
+    { cmd: '/key set <provider> <key>', desc: 'Set API key (e.g., /key set modal sk-xxx)' },
+    { cmd: '/channel', desc: 'Show messaging channels status' },
+    { cmd: '/clear', desc: 'Clear conversation' },
+    { cmd: '/quit', desc: 'Exit chat mode (terminal only)' },
+];
+export async function handleChatCommand(command, platform) {
+    const parts = command.toLowerCase().trim().split(/\s+/);
+    const cmd = parts[0];
+    const args = command.trim().substring(cmd.length).trim();
+    switch (cmd) {
+        case '/start':
+        case '/menu':
+            return {
+                handled: true,
+                response: `🎯 *TwinClaw Menu*
+
+${CHAT_COMMANDS.map((c) => `${c.cmd} - ${c.desc}`).join('\n')}
+
+_How can I help you today?_`,
+            };
+        case '/help':
+            return {
+                handled: true,
+                response: `📋 *Available Commands:*
+
+${CHAT_COMMANDS.map((c) => `${c.cmd} - ${c.desc}`).join('\n')}
+
+_Just send me a message and I'll respond!_`,
+            };
+        case '/status':
+            return {
+                handled: true,
+                response: `✅ *Gateway Status:*
+
+• Status: Running
+• Platform: ${platform}
+• Mode: AI Assistant
+
+_All systems operational_`,
+            };
+        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*
+
+Current: *${currentPrimary}*
+
+`;
+                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 or name>_';
+                return { handled: true, response: modelList };
+            }
+            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 {
+                        return { handled: true, response: '❌ Invalid model number. Use /model list to see available models.' };
+                    }
+                }
+                const config = await readConfig();
+                config.models.primaryModel = newModelId;
+                await writeConfig(config);
+                return {
+                    handled: true,
+                    response: `✅ *Model updated!*
+
+New primary model: *${newModelId}*
+
+Restart TwinClaw for changes to take effect.`,
+                };
+            }
+            else {
+                const config = await readConfig();
+                const currentPrimary = config.models.primaryModel || 'not set';
+                return {
+                    handled: true,
+                    response: `📦 *Models*
+
+Current: *${currentPrimary}*
+
+Commands:
+• /model list - List available models
+• /model set <number> - Set primary model
+
+Example: /model set 1`,
+                };
+            }
+        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(' ');
+                    try {
+                        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 {
+                            return { handled: true, response: `Unknown provider: ${provider}\nValid providers: modal, openrouter, gemini, groq, github` };
+                        }
+                        await writeConfig(config);
+                        return { handled: true, response: `✅ ${provider} API key updated` };
+                    }
+                    catch (err) {
+                        return { handled: true, response: `❌ Error setting key` };
+                    }
+                }
+                else {
+                    return { handled: true, response: `Usage: /key set <provider> <api-key>\n\nExample: /key set modal sk-xxxxx` };
+                }
+            }
+            else {
+                return {
+                    handled: true,
+                    response: `🔑 *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_`,
+                };
+            }
+        case '/channel':
+        case '/channels':
+            return {
+                handled: true,
+                response: `📱 *Channels*
+
+WhatsApp: ✅ Connected
+Telegram: ✅ Connected
+
+Run: *twinclaw channels* in terminal for full details`,
+            };
+        case '/clear':
+            return { handled: true, response: '🗑️ Conversation cleared! Starting fresh.' };
+        case '/quit':
+            if (platform === 'repl') {
+                return { handled: true, response: 'Exiting chat mode. Use Ctrl+C to exit.', shouldExit: true };
+            }
+            return { handled: true, response: 'Quit is only available in terminal REPL.' };
+        case '/persona':
+        case '/config':
+            return {
+                handled: true,
+                response: `Command ${cmd} is best run from the terminal (e.g. twinclaw config).`,
+            };
+        default:
+            return { handled: false };
+    }
+}

package/dist/core/command-router.js

@@ -0,0 +1,290 @@
+import { readConfig, writeConfig } from '../config/json-config.js';
+import { getModelCatalogService } from '../services/model-catalog-service.js';
+export class CommandRouter {
+    gateway;
+    constructor(gateway) {
+        this.gateway = gateway;
+    }
+    /**
+     * Dispatches a /command from a given platform.
+     * Return string is the response to display to the user.
+     */
+    async dispatch(commandText, platform, sessionId) {
+        const parts = commandText.trim().split(/\s+/);
+        const cmd = parts[0].toLowerCase();
+        const args = parts.slice(1).join(' ');
+        switch (cmd) {
+            case '/start':
+            case '/menu':
+            case '/help':
+                return this.handleHelp(platform);
+            case '/status':
+                return this.handleStatus(sessionId, platform);
+            case '/models':
+            case '/model':
+                return this.handleModels(args, platform);
+            case '/keys':
+            case '/key':
+                return this.handleKeys(args, platform);
+            case '/channel':
+            case '/channels':
+                return this.handleChannelStatus(platform);
+            case '/persona':
+                return this.handlePersona(args, platform);
+            case '/doctor':
+                return this.handleDoctor(platform);
+            case '/config':
+                return this.handleConfig(platform);
+            case '/clear':
+                return this.handleClear(platform);
+            case '/quit':
+                if (platform === 'repl') {
+                    return '\nExiting chat mode. Use Ctrl+C to exit.\n';
+                }
+                return `Unknown command: ${cmd}\nType /menu for available commands.`;
+            default:
+                return `Unknown command: ${cmd}\nType /menu for available commands.`;
+        }
+    }
+    handleHelp(platform) {
+        const commands = [
+            { cmd: '/help', desc: 'Show all commands' },
+            { cmd: '/status', desc: 'Show gateway status' },
+            { cmd: '/models', desc: 'Show configured models' },
+            { cmd: '/model set <val>', desc: 'Set primary model (e.g., /model set modal)' },
+            { cmd: '/model list', desc: 'List available models in catalog' },
+            { cmd: '/keys', desc: 'Show API keys status' },
+            { cmd: '/key set <prov> <key>', desc: 'Set API key (e.g., /key set modal sk-xxx)' },
+            { cmd: '/channel', desc: 'Show messaging channels status' },
+            { cmd: '/persona', desc: 'Show current persona' },
+            { cmd: '/doctor', desc: 'Run diagnostics' },
+            { cmd: '/config', desc: 'Open configuration menu (terminal)' },
+            { cmd: '/clear', desc: 'Clear conversation' },
+        ];
+        if (platform === 'repl') {
+            commands.push({ cmd: '/quit', desc: 'Exit chat mode' });
+        }
+        if (platform === 'telegram' || platform === 'whatsapp') {
+            return `🎯 *TwinClaw Menu*\n\n📋 *Available Commands:*\n\n${commands.map(c => `${c.cmd} - ${c.desc}`).join('\n')}\n\n_How can I help you today?_`;
+        }
+        // REPL formatting
+        let output = '\n╔═══════════════════════════════════════════╗\n';
+        output += '║         TwinClaw Chat Commands            ║\n';
+        output += '╠═══════════════════════════════════════════╣\n';
+        for (const c of commands) {
+            output += `║ ${c.cmd.padEnd(35)} ║\n`;
+            output += `║   ${c.desc.padEnd(33)} ║\n`;
+            output += '║                                          ║\n';
+        }
+        output += '╚═══════════════════════════════════════════╝\n';
+        return output;
+    }
+    handleStatus(sessionId, platform) {
+        if (platform === 'telegram' || platform === 'whatsapp') {
+            return `✅ *Gateway Status:*\n\n• Status: Running\n• Platform: ${platform === 'telegram' ? 'Telegram' : 'WhatsApp'}\n• Mode: AI Assistant\n\n_All systems operational_`;
+        }
+        return `\n--- Gateway Status ---\nStatus: Running ✅\nSession: ${sessionId}\n----------------------\n`;
+    }
+    async handleModels(args, platform) {
+        if (args.startsWith('list')) {
+            const catalog = getModelCatalogService().getAllModels();
+            const config = await readConfig();
+            const currentPrimary = config.models.primaryModel || 'not set';
+            const isMd = platform === 'telegram' || platform === 'whatsapp';
+            let modelList = isMd ? `📦 *Available Models*\n\nCurrent: *${currentPrimary}*\n\n` : `\n--- Model Catalog ---\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 += isMd ? `*${provider.toUpperCase()}:*\n` : `${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 += isMd ? '_To switch: /model set <number or id>_' : 'To switch: /model set <number or id>';
+            if (platform === 'repl')
+                modelList += '\n--------------------\n';
+            return modelList;
+        }
+        else if (args.startsWith('set ')) {
+            const modelIdOrNum = args.substring(4).trim();
+            if (!modelIdOrNum) {
+                return `Usage: /model set <provider/model or number>\n\nExamples:\n  /model set modal\n  /model set 1\n  /model set openrouter/meta-llama/llama-3.3-70b-instruct`;
+            }
+            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 {
+                    return `❌ Invalid model number. Use /model list to see available models.`;
+                }
+            }
+            else {
+                // Allow setting provider/model string dynamically
+                if (!newModelId.includes('/')) {
+                    // Usually handled gracefully by ModelRouter if it maps to a well-known default provider,
+                    // but we can warn.
+                }
+            }
+            try {
+                const config = await readConfig();
+                config.models.primaryModel = newModelId;
+                await writeConfig(config);
+                const isMd = platform === 'telegram' || platform === 'whatsapp';
+                return isMd
+                    ? `✅ *Model updated!*\n\nNew primary model: *${newModelId}*\n\nRestart TwinClaw for changes to take effect.`
+                    : `\n✅ Primary model set to: ${newModelId}\n\nNote: Restart gateway for changes to take effect.`;
+            }
+            catch (err) {
+                return `Error setting model: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        }
+        else {
+            try {
+                const config = await readConfig();
+                const currentPrimary = config.models.primaryModel || 'not set';
+                const isMd = platform === 'telegram' || platform === 'whatsapp';
+                if (isMd) {
+                    return `📦 *Models*\n\nCurrent: *${currentPrimary}*\n\nCommands:\n• /model list - List available models\n• /model set <number or id> - Set primary model\n\nExample: /model set 1`;
+                }
+                let out = `\n--- Models ---\nPrimary: ${currentPrimary}\n`;
+                if (config.models.definitions?.length) {
+                    out += '\nConfigured Models:\n';
+                    for (const def of config.models.definitions) {
+                        const isPrimary = def.model === currentPrimary || def.id === currentPrimary ? ' *' : '';
+                        out += `  - ${def.provider}/${def.model}${isPrimary}\n`;
+                    }
+                }
+                out += '\nTo change: /model set <provider/model or number>\n-----------\n';
+                return out;
+            }
+            catch (err) {
+                return `Error: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        }
+    }
+    async handleKeys(args, platform) {
+        const isMd = platform === 'telegram' || platform === 'whatsapp';
+        if (args.startsWith('set ')) {
+            const keyParts = args.substring(4).trim().split(/\s+/);
+            if (keyParts.length >= 2) {
+                const provider = keyParts[0];
+                const key = keyParts.slice(1).join(' ');
+                if (isMd) {
+                    return `🔐 To set *${provider}* API key, run in your terminal:\n\n\`twinclaw secret set ${provider.toUpperCase()}_API_KEY ${key}\`\n\n_Or use: twinclaw config edit_`;
+                }
+                try {
+                    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 {
+                        return `Unknown provider: ${provider}\nValid providers: modal, openrouter, gemini, groq, github`;
+                    }
+                    await writeConfig(config);
+                    return `\n✅ ${provider} API key updated\n`;
+                }
+                catch (err) {
+                    return `Error setting key: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            }
+            else {
+                return `Usage: /key set <provider> <api-key>\n\nExample: /key set modal sk-xxxxx`;
+            }
+        }
+        if (isMd) {
+            return `🔑 *API Keys*\n\nUse *twinclaw config* in terminal to manage API keys.\n\nCommands:\n• /keys show - Show key status\n• /key set <provider> <key> - Set API key\n\n_Or run: twinclaw config_`;
+        }
+        try {
+            const config = await readConfig();
+            let out = '\n╔═══════════════════════════════════════════╗\n';
+            out += '║         Current Configuration            ║\n';
+            out += '╠═══════════════════════════════════════════╣\n';
+            out += `║ API Keys                                     ║\n`;
+            out += `║   Modal: ${config.models.modalApiKey ? '***set***' : 'not set'.padEnd(22)} ║\n`;
+            out += `║   OpenRouter: ${config.models.openRouterApiKey ? '***set***' : 'not set'.padEnd(17)} ║\n`;
+            out += `║   Gemini: ${config.models.geminiApiKey ? '***set***' : 'not set'.padEnd(21)} ║\n`;
+            out += `║   Groq: ${config.messaging.voice.groqApiKey ? '***set***' : 'not set'.padEnd(24)} ║\n`;
+            out += `║   GitHub: ${config.models.githubToken ? '***set***' : 'not set'.padEnd(21)} ║\n`;
+            out += '╚═══════════════════════════════════════════╝\n';
+            return out;
+        }
+        catch (err) {
+            return `Error loading config: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    }
+    async handleChannelStatus(platform) {
+        const isMd = platform === 'telegram' || platform === 'whatsapp';
+        try {
+            const config = await readConfig();
+            if (isMd) {
+                return `📱 *Channels*\n\nTelegram: ${config.messaging.telegram.enabled ? '✅ Connected' : '❌ Disabled'}\nWhatsApp: ${config.messaging.whatsapp.enabled ? '✅ Connected' : '❌ Disabled'}\n\nRun: *twinclaw channels* in terminal to manage`;
+            }
+            let out = '\n--- Messaging Channels ---\n';
+            out += `Telegram: ${config.messaging.telegram.enabled ? 'enabled' : 'disabled'}\n`;
+            if (config.messaging.telegram.enabled) {
+                out += `  Bot Token: ${config.messaging.telegram.botToken ? '***set***' : 'not set'}\n`;
+                out += `  User ID: ${config.messaging.telegram.userId || 'not set'}\n`;
+                out += `  Allow From: ${config.messaging.telegram.allowFrom.join(', ') || 'none'}\n`;
+            }
+            out += `\nWhatsApp: ${config.messaging.whatsapp.enabled ? 'enabled' : 'disabled'}\n`;
+            if (config.messaging.whatsapp.enabled) {
+                out += `  Phone: ${config.messaging.whatsapp.phoneNumber || 'not set'}\n`;
+                out += `  Allow From: ${config.messaging.whatsapp.allowFrom.join(', ') || 'none'}\n`;
+            }
+            out += '\nTo configure: twinclaw channels\n--------------\n';
+            return out;
+        }
+        catch (err) {
+            return `Error: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    }
+    handlePersona(args, platform) {
+        const isMd = platform === 'telegram' || platform === 'whatsapp';
+        if (isMd) {
+            return `👤 *Persona*\n\nRun: *twinclaw persona* in terminal to view/edit\n\nCommands:\n• twinclaw persona show - View persona\n• twinclaw persona edit soul "text" - Edit soul`;
+        }
+        return '\nTo view/edit persona, use: twinclaw persona\nTo edit in chat: /persona edit <soul|identity|user> <text>\n--------------\n';
+    }
+    handleDoctor(platform) {
+        const isMd = platform === 'telegram' || platform === 'whatsapp';
+        if (isMd) {
+            return `🩺 *Diagnostics*\n\nRun: *twinclaw doctor* in terminal to check system health\n\nChecks:\n• Environment variables\n• API keys\n• Configuration\n• Channels`;
+        }
+        return '\nRunning diagnostics...\n\nUse: twinclaw doctor\n------\n';
+    }
+    handleConfig(platform) {
+        const isMd = platform === 'telegram' || platform === 'whatsapp';
+        if (isMd) {
+            return `⚙️ *Configuration*\n\nUse: *twinclaw config* in terminal to:\n• Edit configuration\n• Set API keys\n• Change models\n• Manage channels\n\nRun: *twinclaw config* in terminal`;
+        }
+        return '\n--- Configuration Menu ---\nCommands:\n  /config show     - Show full config\n  /config edit    - Open interactive editor\n  /model set <id> - Change primary model\n  /key set <prov> <key> - Set API key\n------------------------\n';
+    }
+    handleClear(platform) {
+        const isMd = platform === 'telegram' || platform === 'whatsapp';
+        if (isMd) {
+            return '🗑️ Conversation cleared! Starting fresh.';
+        }
+        return '\nConversation cleared.\n';
+    }
+}

package/dist/core/doctor.js

@@ -184,7 +184,7 @@ export function checkEnvVar(check) {
 /** @internal exported for testing */
 export function checkFilesystem(check) {
     const targetMap = {
-        'memory-dir': path.resolve('memory'),
+        'memory-dir': getWorkspaceSubdir('memory'),
         'env-file': path.resolve('.env'),
         'identity-soul': path.join(getIdentityDir(), 'soul.md'),
         'identity-identity': path.join(getIdentityDir(), 'identity.md'),
@@ -245,7 +245,7 @@ export function checkConfigSchema(check) {
 /** @internal exported for testing */
 export function checkChannelAuth(check) {
     if (check.name === 'whatsapp') {
-        const authDir = path.resolve('memory', 'whatsapp_auth');
+        const authDir = path.join(getWorkspaceSubdir('memory'), 'whatsapp_auth');
         if (!fs.existsSync(authDir)) {
             return {
                 check,