twinclaw 1.1.1 → 1.1.2

package/dist/core/simplified-onboarding.js

@@ -1,6 +1,7 @@
 import * as readline from 'readline';
 import { randomBytes } from 'node:crypto';
 import { getConfigPath, readConfig, writeConfig, } from '../config/config-loader.js';
+import { BUILTIN_WINDOWS_SKILLS } from '../config/json-config.js';
 import { initializeWorkspace, getWorkspaceDir } from '../config/workspace.js';
 import { ensureIdentityFiles } from '../config/identity-bootstrap.js';
 import { createSession } from '../services/db.js';
@@ -107,8 +108,17 @@ async function runWhatsAppQRLogin() {
 }
 export async function runSimplifiedOnboarding() {
     console.clear();
-    console.log('═══════════════════════════════════════════════════════════');
-    console.log('              🎉 Welcome to TwinClaw Setup!               ');
+    console.log(`
+▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
+██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
+██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
+██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+                  🦅 TWINCLAW 🦅
+                  
+TwinClaw — Your Agentic AI Gateway
+Multi-Modal Hooks | Proactive Memory | Voice-First
+`);
     console.log('═══════════════════════════════════════════════════════════\n');
     await initializeWorkspace();
     const configPath = getConfigPath();
@@ -161,15 +171,52 @@ export async function runSimplifiedOnboarding() {
         console.log('\n═══════════════════════════════════════════════════════════');
         console.log('  STEP 4: Telegram Setup');
         console.log('═══════════════════════════════════════════════════════════\n');
-        console.log('To get a Telegram Bot Token:');
-        console.log('  1. Open Telegram → @BotFather');
-        console.log('  2. Send /newbot');
-        console.log('  3. Follow instructions and copy the token\n');
-        const telegramToken = await promptSecret('Telegram Bot Token: ');
-        const telegramUserId = await prompt('Telegram User ID (your account): ');
+        console.log('┌────────────────────────────────────────────────────────────────┐');
+        console.log('│  How to get a Telegram Bot Token:                             │');
+        console.log('│                                                                │');
+        console.log('│  1. Open Telegram and chat with @BotFather                    │');
+        console.log('│  2. Send /newbot (or /mybots)                                │');
+        console.log('│  3. Follow instructions and copy the token                    │');
+        console.log('│     (looks like 123456:ABC-DEF...)                           │');
+        console.log('│                                                                │');
+        console.log('│  Tip: You can also set TELEGRAM_BOT_TOKEN in your env.       │');
+        console.log('│  Docs: https://docs.twinclaw.ai/telegram                     │');
+        console.log('└────────────────────────────────────────────────────────────────┘\n');
+        const telegramToken = await promptSecret('Enter Telegram bot token: ');
+        console.log('\n┌────────────────────────────────────────────────────────────────┐');
+        console.log('│  Telegram DM Access Policy:                                   │');
+        console.log('│                                                                │');
+        console.log('│  pairing  - Unknown DMs get a pairing code (recommended)      │');
+        console.log('│  allowlist - Only specific users can message                  │');
+        console.log('│  open     - Anyone can message                                 │');
+        console.log('│                                                                │');
+        console.log('│  To approve: twinclaw pairing approve telegram <code>         │');
+        console.log('│  Docs: https://docs.twinclaw.ai/pairing                       │');
+        console.log('└────────────────────────────────────────────────────────────────┘\n');
+        const dmPolicyChoice = await prompt('DM policy [allowlist]: ');
+        const dmPolicies = {
+            '1': 'pairing', 'pairing': 'pairing',
+            '2': 'allowlist', 'allowlist': 'allowlist',
+            '3': 'open', 'open': 'open'
+        };
+        const dmPolicy = dmPolicies[dmPolicyChoice] || 'allowlist';
+        let telegramUserId = null;
+        if (dmPolicy === 'allowlist') {
+            console.log('\n┌────────────────────────────────────────────────────────────────┐');
+            console.log('│  How to find your Telegram User ID:                           │');
+            console.log('│                                                                │');
+            console.log('│  1. DM your bot, then check twinclaw logs (safest)            │');
+            console.log('│  2. Call: https://api.telegram.org/bot<token>/getUpdates     │');
+            console.log('│  3. Third-party: DM @userinfobot or @getidsbot               │');
+            console.log('│                                                                │');
+            console.log('│  Docs: https://docs.twinclaw.ai/telegram                      │');
+            console.log('└────────────────────────────────────────────────────────────────┘\n');
+            const userIdInput = await prompt('Enter Telegram User ID (your account): ');
+            telegramUserId = userIdInput ? userIdInput : null;
+        }
         config.messaging = config.messaging || {
-            telegram: { enabled: false, botToken: '', userId: null },
-            whatsapp: { enabled: false, phoneNumber: '' },
+            telegram: { enabled: false, botToken: '', userId: null, dmPolicy: 'allowlist', groupPolicy: 'allowlist', allowFrom: [] },
+            whatsapp: { enabled: false, phoneNumber: '', dmPolicy: 'allowlist', groupPolicy: 'allowlist', allowFrom: [] },
             voice: { groqApiKey: '' },
             inbound: { enabled: false, debounceMs: 0 },
             streaming: {
@@ -185,19 +232,59 @@ export async function runSimplifiedOnboarding() {
             enabled: !!telegramToken,
             botToken: telegramToken,
             userId: telegramUserId ? parseInt(telegramUserId, 10) : null,
+            dmPolicy,
+            groupPolicy: 'allowlist',
+            allowFrom: telegramUserId ? [telegramUserId] : [],
         };
+        console.log('\n✅ Telegram configured!\n');
     }
     if (useWhatsApp) {
         console.log('\n═══════════════════════════════════════════════════════════');
         console.log('  STEP 5: WhatsApp Setup');
         console.log('═══════════════════════════════════════════════════════════\n');
+        console.log('┌────────────────────────────────────────────────────────────────┐');
+        console.log('│  How to link WhatsApp:                                         │');
+        console.log('│                                                                │');
+        console.log('│  1. Open WhatsApp on your phone                               │');
+        console.log('│  2. Tap Menu (⋮) → Linked Devices                           │');
+        console.log('│  3. Tap "Link a Device" and scan the QR code                │');
+        console.log('│                                                                │');
+        console.log('│  Note: WhatsApp session persists after setup.                 │');
+        console.log('│  Docs: https://docs.twinclaw.ai/whatsapp                      │');
+        console.log('└────────────────────────────────────────────────────────────────┘\n');
         const startWhatsApp = await promptYesNo('Start WhatsApp QR code login now?', true);
         if (startWhatsApp) {
+            console.log('\n');
             const success = await runWhatsAppQRLogin();
             if (success) {
+                console.log('\n┌────────────────────────────────────────────────────────────────┐');
+                console.log('│  WhatsApp DM Access Policy:                                    │');
+                console.log('│                                                                │');
+                console.log('│  allowlist - Only specific numbers can message (recommended)  │');
+                console.log('│  open     - Anyone can message                                 │');
+                console.log('│                                                                │');
+                console.log('│  To approve: twinclaw pairing approve whatsapp <code>         │');
+                console.log('│  Docs: https://docs.twinclaw.ai/pairing                        │');
+                console.log('└────────────────────────────────────────────────────────────────┘\n');
+                const waDmPolicyChoice = await prompt('DM policy [allowlist]: ');
+                const waDmPolicies = {
+                    '1': 'allowlist', 'allowlist': 'allowlist',
+                    '2': 'open', 'open': 'open'
+                };
+                const waDmPolicy = waDmPolicies[waDmPolicyChoice] || 'allowlist';
+                let waAllowFrom = [];
+                if (waDmPolicy === 'allowlist') {
+                    console.log('\nEnter phone numbers that can message TwinClaw:');
+                    console.log('  Format: +1234567890 (E.164 format)');
+                    console.log('  Separate multiple numbers with commas\n');
+                    const allowFromInput = await prompt('Phone numbers: ');
+                    waAllowFrom = allowFromInput
+                        ? allowFromInput.split(',').map(p => p.trim()).filter(p => p)
+                        : [];
+                }
                 config.messaging = config.messaging || {
-                    telegram: { enabled: false, botToken: '', userId: null },
-                    whatsapp: { enabled: false, phoneNumber: '' },
+                    telegram: { enabled: false, botToken: '', userId: null, dmPolicy: 'pairing', groupPolicy: 'allowlist', allowFrom: [] },
+                    whatsapp: { enabled: false, phoneNumber: '', dmPolicy: 'allowlist', groupPolicy: 'allowlist', allowFrom: [] },
                     voice: { groqApiKey: '' },
                     inbound: { enabled: false, debounceMs: 0 },
                     streaming: {
@@ -212,29 +299,84 @@ export async function runSimplifiedOnboarding() {
                 config.messaging.whatsapp = {
                     enabled: true,
                     phoneNumber: '',
+                    dmPolicy: waDmPolicy,
+                    groupPolicy: 'allowlist',
+                    allowFrom: waAllowFrom,
                 };
+                console.log('\n✅ WhatsApp configured!\n');
             }
         }
     }
     console.log('\n═══════════════════════════════════════════════════════════');
-    console.log('  STEP 6: Voice (Optional)');
+    console.log('  STEP 6: Skills (Windows-Focused)');
+    console.log('═══════════════════════════════════════════════════════════\n');
+    console.log('Skills extend TwinClaw with additional capabilities.\n');
+    console.log('Available Windows Skills:');
+    console.log('─'.repeat(60));
+    const windowsSkills = BUILTIN_WINDOWS_SKILLS.filter(s => s.autoInstall || s.os === 'windows' || s.os === 'all');
+    const productivitySkills = windowsSkills.filter(s => s.category === 'productivity');
+    const systemSkills = windowsSkills.filter(s => s.category === 'system');
+    const utilSkills = windowsSkills.filter(s => s.category === 'utilities');
+    const devSkills = windowsSkills.filter(s => s.category === 'development');
+    console.log('\n📦 Productivity (auto-enabled):');
+    for (const skill of productivitySkills) {
+        console.log(`  ✓ ${skill.name} - ${skill.description}`);
+    }
+    console.log('\n🖥️  System (Windows):');
+    for (const skill of systemSkills.slice(0, 8)) {
+        console.log(`  ○ ${skill.name} - ${skill.description}`);
+    }
+    console.log('\n🔧 Development:');
+    for (const skill of devSkills) {
+        console.log(`  ○ ${skill.name} - ${skill.description}`);
+    }
+    console.log('\n📱 Utilities:');
+    for (const skill of utilSkills.slice(0, 6)) {
+        console.log(`  ○ ${skill.name} - ${skill.description}`);
+    }
+    console.log('\n' + '─'.repeat(60));
+    console.log(`Total: ${windowsSkills.length} skills available`);
+    console.log('\nSkills can be configured later with: twinclaw skills list');
+    await promptYesNo('\nContinue (skills can be configured later)?', true);
+    console.log('\n═══════════════════════════════════════════════════════════');
+    console.log('  STEP 7: 🤖 Self-Improving Agent');
+    console.log('═══════════════════════════════════════════════════════════\n');
+    console.log('TwinClaw can automatically improve itself!\n');
+    console.log('🧠 Auto-Learning: Learns from successes and failures');
+    console.log('💚 Self-Healing: Auto-detects and fixes issues');
+    console.log('🔧 Auto-Config: Connects to new services automatically');
+    console.log('🧱 Skill Builder: Creates new skills on demand\n');
+    console.log('┌────────────────────────────────────────────────────────────────┐');
+    console.log('│  Supported Integrations (auto-configure):                      │');
+    console.log('│                                                                │');
+    console.log('│  Slack, Discord, Notion, GitHub, Jira, Linear, Spotify,       │');
+    console.log('│  OpenWeather, Twilio, and more...                            │');
+    console.log('│                                                                │');
+    console.log('│  Just ask: "Connect to Slack" or "Add GitHub integration"    │');
+    console.log('└────────────────────────────────────────────────────────────────┘\n');
+    const enableSelfImprovement = await promptYesNo('Enable self-improving features?', true);
+    console.log('\n═══════════════════════════════════════════════════════════');
+    console.log('  STEP 8: Voice (Optional)');
     console.log('═══════════════════════════════════════════════════════════\n');
     const groqKey = await promptSecret('Groq API Key for voice/STT (optional, press Enter to skip): ');
     config = {
         ...config,
         runtime: {
             apiSecret: apiSecret || randomBytes(24).toString('hex'),
-            apiPort: config.runtime?.apiPort || 3100,
+            apiPort: config.runtime?.apiPort || 67420,
             secretVaultRequired: config.runtime?.secretVaultRequired || [],
         },
         models: {
             openRouterApiKey: openrouterKey || '',
             modalApiKey: modalKey || '',
             geminiApiKey: geminiKey || '',
+            definitions: [],
+            primaryModel: '',
+            fallbackModels: [],
         },
         messaging: config.messaging || {
-            telegram: { enabled: false, botToken: '', userId: null },
-            whatsapp: { enabled: false, phoneNumber: '' },
+            telegram: { enabled: false, botToken: '', userId: null, dmPolicy: 'allowlist', groupPolicy: 'allowlist', allowFrom: [] },
+            whatsapp: { enabled: false, phoneNumber: '', dmPolicy: 'allowlist', groupPolicy: 'allowlist', allowFrom: [] },
             voice: { groqApiKey: '' },
             inbound: { enabled: false, debounceMs: 0 },
             streaming: {

package/dist/index.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
 const require = createRequire(import.meta.url);
-import { handleOnboardCli, runOnboarding, runSetupWizard, startBasicREPL } from './core/onboarding.js';
+import { handleOnboardCli, runOnboarding, runSetupWizard, runSimplifiedOnboarding, startBasicREPL } from './core/onboarding.js';
 import { Gateway } from './core/gateway.js';
 import { handleDoctorCli, handleHelpCli, handleUnknownCommand } from './core/cli.js';
+import { handleSelfImproveCli } from './core/self-improve-cli.js';
 import { HeartbeatService } from './core/heartbeat.js';
 import { Dispatcher } from './interfaces/dispatcher.js';
 import { TelegramHandler } from './interfaces/telegram_handler.js';
@@ -24,7 +25,7 @@ import { logThought } from './utils/logger.js';
 import { PolicyEngine } from './services/policy-engine.js';
 import { savePolicyAuditLog } from './services/db.js';
 import { getSecretVaultService } from './services/secret-vault.js';
-import { getConfigValue, checkAndMigrateWorkspace } from './config/config-loader.js';
+import { getConfigValue, checkAndMigrateWorkspace, readConfig } from './config/config-loader.js';
 import { getIdentityDir, getWorkspaceSubdir } from './config/workspace.js';
 import { handleSecretVaultCli } from './core/secret-vault-cli.js';
 import { handlePairingCli } from './core/pairing-cli.js';
@@ -33,6 +34,10 @@ import { handleGatewayCli } from './core/gateway-cli.js';
 import { handleLogsCli } from './core/logs-cli.js';
 import { getDmPairingService } from './services/dm-pairing.js';
 import { randomUUID } from 'node:crypto';
+import { initializeSelfHealer, getSelfHealingService } from './services/self-healing.js';
+import { initializeSkillBuilder, getSkillBuilder } from './services/skill-builder.js';
+import { initializeAutoConfigurer, getAutoConfigurer } from './services/auto-configurer.js';
+import { initializeLearning, getLearningSystem } from './services/learning-system.js';
 const secretVault = getSecretVaultService();
 const pairingService = getDmPairingService();
 function assertWindowsOnlyRuntime() {
@@ -47,6 +52,9 @@ assertWindowsOnlyRuntime();
 if (handleHelpCli(process.argv.slice(2))) {
     process.exit(process.exitCode ?? 0);
 }
+if (await handleSelfImproveCli(process.argv.slice(2))) {
+    process.exit(process.exitCode ?? 0);
+}
 if (handleDoctorCli(process.argv.slice(2))) {
     process.exit(process.exitCode ?? 0);
 }
@@ -100,11 +108,8 @@ async function tryAutoSetup() {
     catch (error) {
         console.log("\n[TwinClaw] Welcome! Critical configuration missing.");
         console.log("Starting the interactive setup wizard to configure your agent.\n");
-        const result = await runSetupWizard();
-        if (result.status !== 'success') {
-            const exitCode = result.status === 'cancelled' ? 130 : 1;
-            process.exit(exitCode);
-        }
+        await runSimplifiedOnboarding();
+        await runSetupWizard();
         console.log("\n[TwinClaw] Setup complete. Initializing Gateway...\n");
     }
 }
@@ -143,6 +148,23 @@ fileWatcher.addTarget({
 // ── MCP Skill Registry & Server Manager ──────────────────────────────────────
 const skillRegistry = new SkillRegistry();
 skillRegistry.registerMany(createBuiltinSkills());
+// ── Self-Improving Services ───────────────────────────────────────────────────
+const selfHealer = getSelfHealingService();
+const skillBuilder = getSkillBuilder();
+const autoConfigurer = getAutoConfigurer();
+const learningSystem = getLearningSystem();
+void (async () => {
+    try {
+        await initializeSelfHealer();
+        await initializeSkillBuilder();
+        await initializeAutoConfigurer();
+        await initializeLearning();
+        void logThought('[TwinClaw] Self-improving services initialized');
+    }
+    catch (err) {
+        console.warn('[TwinClaw] Self-improving services init warning:', err);
+    }
+})();
 const mcpManager = new McpServerManager(skillRegistry);
 void (async () => {
     try {
@@ -187,32 +209,41 @@ const telegramBotToken = secretVault.readSecret('TELEGRAM_BOT_TOKEN');
 const telegramUserId = getConfigValue('TELEGRAM_USER_ID')?.trim();
 const whatsappPhoneNumber = secretVault.readSecret('WHATSAPP_PHONE_NUMBER') ?? getConfigValue('WHATSAPP_PHONE_NUMBER');
 const groqApiKey = secretVault.readSecret('GROQ_API_KEY');
+const twinClawConfig = await readConfig();
 let dispatcher = null;
 if (telegramBotToken || whatsappPhoneNumber) {
-    if (groqApiKey) {
-        let telegramHandler;
-        let whatsappHandler;
-        const telegramAllowFrom = [];
-        const whatsappAllowFrom = [];
-        if (telegramBotToken) {
-            telegramHandler = new TelegramHandler(telegramBotToken);
-            if (telegramUserId) {
-                const parsedTelegramUserId = Number(telegramUserId);
-                if (!Number.isInteger(parsedTelegramUserId) || parsedTelegramUserId <= 0) {
-                    console.error('[TwinClaw] TELEGRAM_USER_ID must be a positive integer when provided.');
-                }
-                else {
-                    telegramAllowFrom.push(String(parsedTelegramUserId));
-                }
+    let telegramHandler;
+    let whatsappHandler;
+    let sttService;
+    let ttsService;
+    const telegramAllowFrom = [...(twinClawConfig.messaging.telegram?.allowFrom || [])];
+    const whatsappAllowFrom = [...(twinClawConfig.messaging.whatsapp?.allowFrom || [])];
+    if (telegramBotToken) {
+        telegramHandler = new TelegramHandler(telegramBotToken);
+        if (telegramUserId) {
+            const parsedTelegramUserId = Number(telegramUserId);
+            if (!Number.isInteger(parsedTelegramUserId) || parsedTelegramUserId <= 0) {
+                console.error('[TwinClaw] TELEGRAM_USER_ID must be a positive integer when provided.');
+            }
+            else {
+                telegramAllowFrom.push(String(parsedTelegramUserId));
             }
         }
-        if (whatsappPhoneNumber) {
-            whatsappHandler = new WhatsAppHandler();
+    }
+    if (whatsappPhoneNumber) {
+        whatsappHandler = new WhatsAppHandler();
+        if (!whatsappAllowFrom.includes(whatsappPhoneNumber)) {
             whatsappAllowFrom.push(whatsappPhoneNumber);
         }
-        const sttService = new SttService(groqApiKey);
-        const ttsService = new TtsService(groqApiKey);
-        // Initialize persistent delivery queue
+    }
+    if (groqApiKey) {
+        sttService = new SttService(groqApiKey);
+        ttsService = new TtsService(groqApiKey);
+    }
+    else {
+        console.warn('[TwinClaw] GROQ_API_KEY not set. Voice/STT features disabled.');
+    }
+    if (telegramHandler || whatsappHandler) {
         const queueService = new QueueService(async (platform, chatId, text) => {
             switch (platform) {
                 case 'telegram':
@@ -233,19 +264,16 @@ if (telegramBotToken || whatsappPhoneNumber) {
         dispatcher = new Dispatcher(telegramHandler, whatsappHandler, sttService, ttsService, gateway, queueService, {
             pairingService,
             telegram: {
-                dmPolicy: 'pairing',
+                dmPolicy: 'allowlist',
                 allowFrom: telegramAllowFrom,
             },
             whatsapp: {
-                dmPolicy: 'pairing',
+                dmPolicy: 'allowlist',
                 allowFrom: whatsappAllowFrom,
             },
         });
         void logThought('[TwinClaw] Messaging dispatcher and persistent queue initialized.');
     }
-    else {
-        console.warn('[TwinClaw] Dispatcher requires GROQ_API_KEY.');
-    }
 }
 else {
     console.log('[TwinClaw] Messaging dispatcher not initialized (missing Telegram AND WhatsApp configs).');
@@ -305,7 +333,7 @@ const runtimeEventProducer = new RuntimeEventProducer({
     dispatcher: dispatcher ?? undefined,
     modelRouter,
 });
-const apiPort = Number(getConfigValue('API_PORT')) || 18789;
+const apiPort = Number(getConfigValue('API_PORT')) || 67420;
 startApiServer({
     heartbeat,
     skillRegistry,

package/dist/interfaces/dispatcher.js

@@ -5,7 +5,7 @@ import { InboundDebounceService } from '../services/inbound-debounce.js';
 import { EmbeddedBlockChunker } from '../services/block-chunker.js';
 import { getConfigValue } from '../config/config-loader.js';
 const DEFAULT_ACCESS_CONFIG = {
-    dmPolicy: 'pairing',
+    dmPolicy: 'allowlist',
     allowFrom: [],
 };
 function buildPairingChallenge(channel, code) {
@@ -154,7 +154,9 @@ export class Dispatcher {
         const filePath = message.audioFilePath;
         let transcribedText;
         try {
-            transcribedText = await this.#stt.transcribeFile(filePath);
+            if (this.#stt) {
+                transcribedText = await this.#stt.transcribeFile(filePath);
+            }
         }
         finally {
             fs.unlink(filePath, (unlinkErr) => {