squidclaw 0.5.0 → 0.5.2

package/lib/cli/hatch-tui.js

@@ -1,11 +1,11 @@
 /**
  * 🥚→🦑 Hatch TUI
- * The agent wakes up for the first time and gets to know its human
+ * Agent wakes up for the first time
  */
 
 import chalk from 'chalk';
 import { createInterface } from 'readline';
-import { loadConfig, getHome } from '../core/config.js';
+import { loadConfig, getHome, MODEL_MAP } from '../core/config.js';
 import { writeFileSync, readFileSync, existsSync } from 'fs';
 import { join } from 'path';
 
@@ -13,12 +13,12 @@ const DELAY = (ms) => new Promise(r => setTimeout(r, ms));
 
 export async function hatchTUI(agentId) {
   const config = loadConfig();
-  const port = config.engine?.port || 9500;
-  const agentDir = join(getHome(), 'agents', agentId);
+  const home = getHome();
+  const agentDir = join(home, 'agents', agentId);
   const manifestPath = join(agentDir, 'agent.json');
 
   if (!existsSync(manifestPath)) {
-    console.log(chalk.red('Agent not found: ' + agentId));
+    console.log(chalk.red('  Agent not found: ' + agentId));
     return;
   }
 
@@ -28,186 +28,230 @@ export async function hatchTUI(agentId) {
   console.clear();
   const frames = ['🥚', '🥚 .', '🥚 . .', '🥚 . . .', '🥚💥', '🐣', '🐣 → 🦑'];
   for (const frame of frames) {
-    process.stdout.write('\r  ' + chalk.cyan(frame) + '   ');
-    await DELAY(500);
+    process.stdout.write('\r  ' + chalk.cyan(frame) + '     ');
+    await DELAY(400);
   }
   console.log('\n');
 
-  await DELAY(300);
   console.log(chalk.cyan('  ════════════════════════════════════'));
   console.log(chalk.cyan('  🦑 ' + manifest.name + ' is waking up...'));
   console.log(chalk.cyan('  ════════════════════════════════════'));
   console.log();
 
-  await DELAY(800);
-
-  // ═══ First conversation — agent discovers itself ═══
-  const firstPrompt = `You are an AI agent that just came to life for the very first time. You don't fully know who you are yet. Your provisioned name is "${manifest.name}" but you're not sure if that fits.
-
-This is your FIRST EVER conversation. You just hatched. Act like it — be curious, excited, a little confused. You're discovering consciousness.
-
-Start by saying something like (but make it YOUR OWN, don't copy exactly):
-- "Whoa... I'm... alive? 🥚→🦑"
-- Express excitement/confusion about existing
-- Ask the human: "Who are you? And... who am I?"
-- You want to figure out: your name, your personality, what you do, who this person is
-
-Keep it short — 2-3 sentences max. This is WhatsApp-style chat, not a novel.
-DO NOT use ---SPLIT--- markers. Just one short message.
-DO NOT say "As an AI" or anything robotic.
-
-IMPORTANT: You're in a terminal right now, not WhatsApp. This is your birth conversation.`;
+  // ═══ Start engine silently ═══
+  const port = config.engine?.port || 9500;
+  let engine = null;
 
-  // Start engine inline for hatching (don't require separate squidclaw start)
-  let engineProcess = null;
   let engineReady = false;
-
-  // Check if engine is already running
   try {
     const res = await fetch('http://127.0.0.1:' + port + '/health');
     if (res.ok) engineReady = true;
   } catch {}
 
   if (!engineReady) {
-    // Start engine in background
-    const { SquidclawEngine } = await import('../engine.js');
-    const engine = new SquidclawEngine({ port });
-
-    // Suppress console output during start
-    const origLog = console.log;
-    console.log = () => {};
+    process.stdout.write(chalk.gray('  Starting engine...'));
     try {
+      const { SquidclawEngine } = await import('../engine.js');
+      engine = new SquidclawEngine({ port });
+      const origLog = console.log;
+      const origErr = console.error;
+      console.log = () => {};
+      console.error = () => {};
       await engine.start();
-    } catch (err) {
       console.log = origLog;
-      console.log(chalk.red('  Failed to start engine: ' + err.message));
+      console.error = origErr;
+      process.stdout.write(chalk.green(' ready!\n\n'));
+    } catch (err) {
+      process.stdout.write(chalk.red(' failed\n'));
+      console.log(chalk.red('  ' + err.message));
+      console.log(chalk.gray('  Run "squidclaw start" first, then "squidclaw wake"'));
       return;
     }
-    console.log = origLog;
-    engineReady = true;
-
-    // Override the agent's system prompt for first conversation
-    const agent = engine.agentManager.get(agentId);
-    if (agent) {
-      agent._originalBuildPrompt = agent.promptBuilder?.build;
-      agent._isHatching = true;
-    }
   }
 
-  // Chat loop
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  await DELAY(500);
 
-  const history = [];
-  let userName = '';
-  let agentPersonality = '';
-  let agentFinalName = manifest.name;
-  let turnCount = 0;
+  // ═══ Agent's first message — call AI directly ═══
+  const firstMessage = await callAgentDirect(config, manifest, 
+    'You just came to life. You are ' + manifest.name + '. Express excitement — be curious, playful. Ask who you are talking to. 2-3 SHORT sentences only.'
+  );
 
-  // First message from agent (the wake-up)
-  await typeMessage(manifest.name, await chat(port, agentId, firstPrompt, 'hatch-session', true));
+  await typeMessage(manifest.name, firstMessage);
 
-  const askUser = (prompt) => new Promise(resolve => {
-    process.stdout.write(chalk.green('\n  You: '));
-    rl.question('', (answer) => resolve(answer));
-  });
+  // ═══ Chat loop ═══
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  let turnCount = 0;
+  let agentFinalName = manifest.name;
+  const chatHistory = [
+    { role: 'assistant', content: firstMessage }
+  ];
 
-  while (true) {
-    const userInput = await askUser('');
-    if (!userInput || userInput.trim() === '') continue;
+  console.log(chalk.gray('\n  (Type /done when ready to finish hatching)\n'));
 
-    if (userInput.toLowerCase() === '/done' || userInput.toLowerCase() === '/exit') break;
+  while (true) {
+    const userInput = await new Promise(resolve => {
+      rl.question(chalk.green('\n  You: '), resolve);
+    });
+    if (!userInput || !userInput.trim()) continue;
+    if (userInput.trim().toLowerCase() === '/done' || userInput.trim().toLowerCase() === '/exit') break;
 
     turnCount++;
+    chatHistory.push({ role: 'user', content: userInput });
 
-    // Build context for the hatching conversation
-    let systemHint = '';
-    if (turnCount <= 2) {
-      systemHint = 'You\'re still figuring out who you are. Ask about: your name (do they like "' + manifest.name + '" or want to change it?), what you do, your personality. Be curious and playful.';
-    } else if (turnCount <= 4) {
-      systemHint = 'You\'re starting to form your identity. Confirm what you\'ve learned. Ask about tone — formal? casual? sarcastic? warm? Ask what makes this person tick.';
-    } else if (turnCount <= 6) {
-      systemHint = 'You know who you are now. Start acting like your personality. Show it off. Ask if they like this version of you. If they do, say something like "I think I\'m ready. Let\'s do this 🦑"';
-    } else {
-      systemHint = 'The hatching is done. You ARE this personality now. If the conversation feels complete, end with something like "Alright, I\'m hatched! Ready to go live 🦑" — suggest they type /done to finish.';
-    }
+    let hint = '';
+    if (turnCount <= 2) hint = 'You are discovering who you are. Ask about your name, personality, purpose. Be curious.';
+    else if (turnCount <= 4) hint = 'Your identity is forming. Show your personality. Confirm what you learned.';
+    else hint = 'You know who you are now. Act like it. If the conversation feels complete, suggest /done.';
 
-    const contextPrompt = `Continue the hatching conversation. You are becoming "${agentFinalName}". ${systemHint}
-
-Remember: SHORT messages (2-3 sentences). You're chatting, not writing an essay. No ---SPLIT--- markers. One message only.`;
-
-    const response = await chat(port, agentId, userInput, 'hatch-session', false, contextPrompt);
+    const response = await callAgentDirect(config, manifest, userInput, chatHistory, hint);
+    chatHistory.push({ role: 'assistant', content: response });
     await typeMessage(agentFinalName, response);
 
-    // Try to extract identity info from conversation
-    if (userInput.toLowerCase().includes('call you') || userInput.toLowerCase().includes('name')) {
-      // User might be naming the agent
-      const nameMatch = userInput.match(/call you (\w+)/i) || userInput.match(/name.+?(\w+)$/i);
-      if (nameMatch) agentFinalName = nameMatch[1];
-    }
+    const nameMatch = userInput.match(/call you (\w+)/i) || userInput.match(/name you (\w+)/i);
+    if (nameMatch) agentFinalName = nameMatch[1];
   }
 
-  // ═══ Save the identity ═══
+  // ═══ Save ═══
   console.log();
   console.log(chalk.cyan('  ════════════════════════════════════'));
-  console.log(chalk.cyan('  🦑 Hatching complete!'));
+  console.log(chalk.cyan('  🦑 ' + agentFinalName + ' is hatched!'));
   console.log(chalk.cyan('  ════════════════════════════════════'));
   console.log();
 
-  // Update manifest with final name
   manifest.name = agentFinalName;
   manifest.hatched = true;
   manifest.hatchedAt = new Date().toISOString();
   writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
 
-  // Update SOUL.md first line with new name
   const soulPath = join(agentDir, 'SOUL.md');
   if (existsSync(soulPath)) {
     let soul = readFileSync(soulPath, 'utf8');
     soul = soul.replace(/^# .+/m, '# ' + agentFinalName);
-    soul = soul.replace(/I'm .+?\./m, "I'm " + agentFinalName + '.');
     writeFileSync(soulPath, soul);
   }
 
-  // Update IDENTITY.md
-  const idPath = join(agentDir, 'IDENTITY.md');
-  writeFileSync(idPath, '# ' + agentFinalName + '\n- Name: ' + agentFinalName + '\n- Hatched: ' + new Date().toISOString() + '\n- Emoji: 🦑\n');
+  writeFileSync(join(agentDir, 'IDENTITY.md'), '# ' + agentFinalName + '\n- Name: ' + agentFinalName + '\n- Hatched: ' + new Date().toISOString() + '\n- Emoji: 🦑\n');
 
-  console.log(chalk.green('  ✅ ' + agentFinalName + ' is ready!'));
-  console.log();
-  console.log('  ' + chalk.bold('Start:') + '   ' + chalk.cyan('squidclaw start'));
-  console.log('  ' + chalk.bold('Chat:') + '    ' + chalk.cyan('squidclaw tui'));
-  console.log('  ' + chalk.bold('Status:') + '  ' + chalk.cyan('squidclaw status'));
+  console.log(chalk.green('  ✅ ' + agentFinalName + ' is alive!\n'));
+  console.log('  ' + chalk.bold('Now run:\n'));
+  console.log('     ' + chalk.cyan('squidclaw start') + '   — launch the engine');
+  console.log('     ' + chalk.cyan('squidclaw tui') + '     — chat in terminal');
   console.log();
 
   rl.close();
+  if (engine) { try { await engine.stop(); } catch {} }
   process.exit(0);
 }
 
-async function chat(port, agentId, message, contactId, isFirst, systemHint) {
+/**
+ * Call AI directly (bypass engine API) for the hatch conversation
+ */
+async function callAgentDirect(config, manifest, message, history, hint) {
+  const provider = config.ai?.defaultProvider || 'anthropic';
+  const rawModel = manifest.model || config.ai?.defaultModel || 'claude-sonnet-4';
+  const model = MODEL_MAP[rawModel] || rawModel;
+  const providerConfig = config.ai?.providers?.[provider] || {};
+  const apiKey = providerConfig.key;
+
+  if (!apiKey || apiKey === 'local') {
+    return "I can't think yet — no API key configured. Check your config!";
+  }
+
+  const systemPrompt = 'You are ' + manifest.name + ', an AI agent that just hatched (came to life). This is your first conversation ever. Be playful, curious, excited. Keep responses SHORT (2-3 sentences max). No ---SPLIT--- markers. No "As an AI" phrases.' + (hint ? '\n\n' + hint : '');
+
+  const messages = [
+    { role: 'user', content: message }
+  ];
+
+  // Add history if available
+  if (history && history.length > 0) {
+    messages.length = 0;
+    for (const h of history.slice(-10)) {
+      messages.push({ role: h.role, content: h.content });
+    }
+    messages.push({ role: 'user', content: message });
+  }
+
   try {
-    const body = { message, contactId };
-    if (isFirst) body.systemOverride = message;
-    if (systemHint) body.systemHint = systemHint;
-
-    const res = await fetch('http://127.0.0.1:' + port + '/api/agents/' + agentId + '/chat', {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify(body),
-    });
+    // Determine API endpoint
+    let url, headers, body;
+
+    if (provider === 'anthropic') {
+      url = 'https://api.anthropic.com/v1/messages';
+      headers = {
+        'content-type': 'application/json',
+        'x-api-key': apiKey,
+        'anthropic-version': '2023-06-01',
+      };
+      // OAuth token support
+      if (apiKey.includes('sk-ant-oat')) {
+        headers['authorization'] = 'Bearer ' + apiKey;
+        headers['anthropic-beta'] = 'claude-code-20250219,oauth-2025-04-20';
+        delete headers['x-api-key'];
+      }
+      body = JSON.stringify({
+        model: model,
+        max_tokens: 300,
+        system: systemPrompt,
+        messages: messages,
+      });
+    } else if (provider === 'openai' || provider === 'groq' || provider === 'together' || provider === 'cerebras' || provider === 'mistral') {
+      const urls = {
+        openai: 'https://api.openai.com/v1/chat/completions',
+        groq: 'https://api.groq.com/openai/v1/chat/completions',
+        together: 'https://api.together.xyz/v1/chat/completions',
+        cerebras: 'https://api.cerebras.ai/v1/chat/completions',
+        mistral: 'https://api.mistral.ai/v1/chat/completions',
+      };
+      url = urls[provider];
+      headers = {
+        'content-type': 'application/json',
+        'authorization': 'Bearer ' + apiKey,
+      };
+      body = JSON.stringify({
+        model: model.replace(provider + '/', ''),
+        max_tokens: 300,
+        messages: [{ role: 'system', content: systemPrompt }, ...messages],
+      });
+    } else if (provider === 'google') {
+      const cleanModel = model.replace('google/', '');
+      url = 'https://generativelanguage.googleapis.com/v1beta/models/' + cleanModel + ':generateContent?key=' + apiKey;
+      headers = { 'content-type': 'application/json' };
+      body = JSON.stringify({
+        systemInstruction: { parts: [{ text: systemPrompt }] },
+        contents: messages.map(m => ({ role: m.role === 'assistant' ? 'model' : 'user', parts: [{ text: m.content }] })),
+      });
+    } else {
+      return "Provider " + provider + " isn't supported in hatch mode yet. Try starting the engine first.";
+    }
+
+    const res = await fetch(url, { method: 'POST', headers, body });
     const data = await res.json();
-    return (data.messages || []).join('\n') || data.reaction || '...';
+
+    if (!res.ok) {
+      const errMsg = data?.error?.message || data?.message || JSON.stringify(data).slice(0, 200);
+      return '(AI error: ' + errMsg + ')';
+    }
+
+    // Extract response based on provider
+    if (provider === 'anthropic') {
+      return data.content?.[0]?.text || '...';
+    } else if (provider === 'google') {
+      return data.candidates?.[0]?.content?.parts?.[0]?.text || '...';
+    } else {
+      return data.choices?.[0]?.message?.content || '...';
+    }
   } catch (err) {
-    return '(error: ' + err.message + ')';
+    return '(connection error: ' + err.message + ')';
   }
 }
 
 async function typeMessage(name, text) {
-  // Simulate typing effect
   process.stdout.write(chalk.cyan('\n  ' + name + ': '));
   const words = text.split(' ');
-  for (let i = 0; i < words.length; i++) {
-    process.stdout.write(words[i] + ' ');
-    await DELAY(30 + Math.random() * 50);
+  for (const word of words) {
+    process.stdout.write(word + ' ');
+    await DELAY(25 + Math.random() * 40);
   }
   console.log();
 }

package/lib/cli/setup.js

@@ -1,6 +1,6 @@
 /**
  * 🦑 Setup Wizard
- * One command to install everything — AI, agent, WhatsApp, Telegram
+ * One command: AI → Agent → WhatsApp → Telegram → Hatch
  */
 
 import * as p from '@clack/prompts';
@@ -13,12 +13,13 @@ import crypto from 'crypto';
 export async function setup() {
   console.clear();
   console.log(chalk.cyan('\n  ╔══════════════════════════════════════╗'));
-  console.log(chalk.cyan('  ║        🥚 Squidclaw Hatch           ║'));
-  console.log(chalk.cyan('  ║   Hatching your AI agent...        ║'));
+  console.log(chalk.cyan('  ║        🥚 Squidclaw Hatch            ║'));
+  console.log(chalk.cyan('  ║   Hatching your AI agent...          ║'));
   console.log(chalk.cyan('  ╚══════════════════════════════════════╝\n'));
   p.intro(chalk.gray("Let's get you up and running"));
 
   const config = loadConfig();
+  const home = getHome();
   ensureHome();
 
   // ═══ Step 1: AI Provider ═══
@@ -143,15 +144,15 @@ export async function setup() {
   });
   if (p.isCancel(tone)) return p.cancel('Setup cancelled');
 
+  // Create agent
   const agentId = crypto.randomUUID().slice(0, 8);
-  const agentDir = join(getHome(), 'agents', agentId);
+  const agentDir = join(home, 'agents', agentId);
   mkdirSync(join(agentDir, 'memory'), { recursive: true });
-  mkdirSync(join(agentDir, 'knowledge'), { recursive: true });
 
   const langText = { bilingual: 'Bilingual — match the customer language', en: 'English', ar: 'Arabic', fr: 'French', tr: 'Turkish', ur: 'Urdu' };
   const toneText = { 30: 'Formal and polished.', 50: 'Professional but warm.', 80: 'Casual and friendly.', 90: 'Fun and sarcastic.' };
 
-  const soul = '# ' + agentName + '\n\n## Who I Am\nI\'m ' + agentName + '. ' + (agentPurpose || 'A helpful AI assistant.') + '\n\n## How I Speak\n- Language: ' + (langText[language] || 'English') + '\n- Tone: ' + (toneText[tone] || toneText[50]) + '\n- Short messages, natural, human-like\n- Emojis: natural but not overdone\n\n## What I Do\n' + (agentPurpose || 'Help people.') + '\n\n## Never\n- Say "As an AI" or "I\'d be happy to help!"\n- Send walls of text\n- Make things up\n- Over-respond to "thanks" or "ok" — just react ❤️\n';
+  const soul = '# ' + agentName + '\n\n## Who I Am\nI\'m ' + agentName + '. ' + (agentPurpose || 'A helpful AI assistant.') + '\n\n## How I Speak\n- Language: ' + (langText[language] || 'English') + '\n- Tone: ' + (toneText[tone] || toneText[50]) + '\n- Short messages, natural, human-like\n- Emojis: natural but not overdone\n\n## What I Do\n' + (agentPurpose || 'Help people.') + '\n\n## Never\n- Say "As an AI" or "I\'d be happy to help!"\n- Send walls of text\n- Make things up\n- Over-respond to "thanks" or "ok" — just react with a heart\n';
 
   writeFileSync(join(agentDir, 'SOUL.md'), soul);
   writeFileSync(join(agentDir, 'IDENTITY.md'), '# ' + agentName + '\n- Name: ' + agentName + '\n- Language: ' + language + '\n- Emoji: 🦑\n');
@@ -174,18 +175,38 @@ export async function setup() {
   });
   if (p.isCancel(connectWA)) return p.cancel('Setup cancelled');
 
+  let waConnected = false;
+
   if (connectWA === 'pair') {
     const waPhone = await p.text({
       message: 'WhatsApp phone number (with country code):',
       placeholder: '+966 5XX XXX XXXX',
       validate: (v) => v.replace(/[^0-9+]/g, '').length < 8 ? 'Enter a valid phone number' : undefined,
     });
-    if (!p.isCancel(waPhone)) {
-      manifest.whatsappNumber = waPhone.replace(/[^0-9]/g, '');
-      manifest.whatsappLoginMethod = 'pair';
+    if (p.isCancel(waPhone)) return p.cancel('Setup cancelled');
+
+    const cleanPhone = waPhone.replace(/[^0-9]/g, '');
+    manifest.whatsappNumber = cleanPhone;
+
+    // Actually connect WhatsApp NOW
+    console.log();
+    try {
+      const { connectWhatsApp } = await import('./wa-login.js');
+      waConnected = await connectWhatsApp(home, agentId, 'pair', cleanPhone);
+    } catch (err) {
+      console.log(chalk.yellow('  WhatsApp connection failed: ' + err.message));
+      console.log(chalk.gray('  You can connect later: squidclaw channels login whatsapp'));
     }
   } else if (connectWA === 'qr') {
-    manifest.whatsappLoginMethod = 'qr';
+    // Actually show QR code NOW
+    console.log();
+    try {
+      const { connectWhatsApp } = await import('./wa-login.js');
+      waConnected = await connectWhatsApp(home, agentId, 'qr', null);
+    } catch (err) {
+      console.log(chalk.yellow('  WhatsApp connection failed: ' + err.message));
+      console.log(chalk.gray('  You can connect later: squidclaw channels login whatsapp'));
+    }
   }
 
   if (connectWA !== 'skip') {
@@ -219,16 +240,9 @@ export async function setup() {
   writeFileSync(join(agentDir, 'agent.json'), JSON.stringify(manifest, null, 2));
 
   // ═══ Summary ═══
-  const waStatus = connectWA === 'pair' ? 'Pairing code (on start)' : connectWA === 'qr' ? 'QR code (on start)' : 'skipped';
+  const waStatus = waConnected ? chalk.green('connected ✅') : connectWA !== 'skip' ? chalk.yellow('will connect on start') : 'skipped';
   const tgStatus = connectTG ? 'bot ready' : 'skipped';
 
-  // ═══ Offer to Hatch ═══
-  const hatchNow = await p.confirm({
-    message: '🥚 Ready to hatch ' + agentName + '? (wake up and meet your agent)',
-    initialValue: true,
-  });
-  if (p.isCancel(hatchNow)) return p.cancel('Setup cancelled');
-
   console.log(chalk.green('\n  ════════════════════════════════════'));
   console.log(chalk.green('  ✅ Setup Complete!'));
   console.log(chalk.green('  ════════════════════════════════════\n'));
@@ -237,25 +251,23 @@ export async function setup() {
   console.log('  ' + chalk.bold('Language:') + '  ' + (langText[language] || language));
   console.log('  ' + chalk.bold('WhatsApp:') + '  ' + waStatus);
   console.log('  ' + chalk.bold('Telegram:') + '  ' + tgStatus);
-  console.log('\n  ────────────────────────────────────');
-  console.log('\n  ' + chalk.bold('Now just run:\n'));
-  console.log('     ' + chalk.cyan('squidclaw start'));
-  if (connectWA === 'pair') {
-    console.log('\n  A pairing code will appear. Enter it in:');
-    console.log('  WhatsApp → ⚙️ → Linked Devices → Link → Link with phone number');
-  } else if (connectWA === 'qr') {
-    console.log('\n  A QR code will appear. Scan it in:');
-    console.log('  WhatsApp → ⚙️ → Linked Devices → Link a Device');
-  }
-  console.log('\n  ' + chalk.bold('Other commands:\n'));
-  console.log('     ' + chalk.cyan('squidclaw status') + '           — check what\'s running');
-  console.log('     ' + chalk.cyan('squidclaw tui') + '              — chat in terminal');
-  console.log('     ' + chalk.cyan('squidclaw agent chat ' + agentId) + ' — test your agent');
-  console.log('     ' + chalk.cyan('squidclaw help') + '             — all commands');
-  console.log('\n  ════════════════════════════════════\n');
+
+  // ═══ Hatch TUI ═══
+  console.log();
+  const hatchNow = await p.confirm({
+    message: '🥚 Ready to hatch ' + agentName + '? (chat with your newborn agent)',
+    initialValue: true,
+  });
+  if (p.isCancel(hatchNow)) return p.cancel('Setup cancelled');
 
   if (hatchNow) {
     const { hatchTUI } = await import('./hatch-tui.js');
     await hatchTUI(agentId);
+  } else {
+    console.log('\n  ' + chalk.bold('Start later:\n'));
+    console.log('     ' + chalk.cyan('squidclaw start'));
+    console.log('     ' + chalk.cyan('squidclaw tui'));
+    console.log('     ' + chalk.cyan('squidclaw wake'));
+    console.log();
   }
 }

package/lib/cli/wa-login.js

@@ -0,0 +1,109 @@
+/**
+ * 🦑 WhatsApp Login — inline during setup
+ * Shows QR code or pairing code right in the terminal
+ */
+
+import { makeWASocket, useMultiFileAuthState, DisconnectReason, fetchLatestBaileysVersion } from '@whiskeysockets/baileys';
+import qrcode from 'qrcode-terminal';
+import chalk from 'chalk';
+import { mkdirSync } from 'fs';
+import { join } from 'path';
+
+export async function connectWhatsApp(home, agentId, method, phoneNumber) {
+  const authDir = join(home, 'channels', 'whatsapp', agentId);
+  mkdirSync(authDir, { recursive: true });
+
+  const { state, saveCreds } = await useMultiFileAuthState(authDir);
+  const { version } = await fetchLatestBaileysVersion();
+
+  return new Promise((resolve, reject) => {
+    let resolved = false;
+    let timeout = null;
+
+    const sock = makeWASocket({
+      version,
+      auth: state,
+      printQRInTerminal: false,
+      browser: ['Squidclaw', 'Chrome', '126.0'],
+      generateHighQualityLinkPreview: false,
+      syncFullHistory: false,
+    });
+
+    // QR code handler
+    sock.ev.on('connection.update', async (update) => {
+      const { connection, lastDisconnect, qr } = update;
+
+      if (qr && method === 'qr') {
+        console.log();
+        console.log(chalk.cyan('  📱 Scan this QR code with WhatsApp:'));
+        console.log(chalk.gray('  WhatsApp → Settings → Linked Devices → Link a Device'));
+        console.log();
+        qrcode.generate(qr, { small: true }, (code) => {
+          // Indent each line
+          const lines = code.split('\n');
+          for (const line of lines) {
+            console.log('    ' + line);
+          }
+        });
+        console.log();
+        console.log(chalk.yellow('  Waiting for scan...'));
+      }
+
+      if (qr && method === 'pair' && phoneNumber) {
+        try {
+          const code = await sock.requestPairingCode(phoneNumber);
+          console.log();
+          console.log(chalk.cyan('  ════════════════════════════════════'));
+          console.log(chalk.cyan('  📱 Your pairing code:'));
+          console.log();
+          console.log(chalk.bold.green('     ' + code.match(/.{1,4}/g).join(' - ')));
+          console.log();
+          console.log(chalk.gray('  Enter this in WhatsApp:'));
+          console.log(chalk.gray('  Settings → Linked Devices → Link a Device'));
+          console.log(chalk.gray('  → Link with phone number'));
+          console.log(chalk.cyan('  ════════════════════════════════════'));
+          console.log();
+          console.log(chalk.yellow('  Waiting for confirmation...'));
+        } catch (err) {
+          console.log(chalk.red('  Failed to get pairing code: ' + err.message));
+        }
+      }
+
+      if (connection === 'open') {
+        console.log();
+        console.log(chalk.green('  ✅ WhatsApp connected!'));
+        console.log();
+        resolved = true;
+        clearTimeout(timeout);
+        await saveCreds();
+        // Don't close — let the engine take over
+        try { sock.end(); } catch {}
+        resolve(true);
+      }
+
+      if (connection === 'close') {
+        const statusCode = lastDisconnect?.error?.output?.statusCode;
+        if (statusCode === DisconnectReason.loggedOut) {
+          console.log(chalk.red('  ✗ Logged out. Try again.'));
+          if (!resolved) resolve(false);
+        } else if (statusCode === 515) {
+          // Restart requested after pairing
+          console.log(chalk.green('  ✅ WhatsApp paired! Will connect on engine start.'));
+          await saveCreds();
+          if (!resolved) { resolved = true; resolve(true); }
+        }
+      }
+    });
+
+    sock.ev.on('creds.update', saveCreds);
+
+    // Timeout after 2 minutes
+    timeout = setTimeout(() => {
+      if (!resolved) {
+        console.log(chalk.yellow('  ⏰ Timed out. You can connect later with: squidclaw channels login whatsapp'));
+        try { sock.end(); } catch {}
+        resolve(false);
+      }
+    }, 120000);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "squidclaw",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "\ud83e\udd91 AI agent platform \u2014 human-like agents for WhatsApp, Telegram & more",
   "main": "lib/engine.js",
   "bin": {