squidclaw 0.2.2 → 0.3.1

package/bin/squidclaw.js

@@ -24,8 +24,9 @@ program
 
 // ── Setup ──────────────────────────────────────────────
 program
-  .command('setup')
-  .description('Interactive first-time setup wizard')
+  .command('hatch')
+  .alias('setup')
+  .description('🥚 Hatch your first Squidclaw agent')
   .action(async () => {
     const { setup } = await import('../lib/cli/setup.js');
     await setup();
@@ -492,7 +493,7 @@ if (process.argv.length <= 2) {
   🦑 Squidclaw v${pkg.version}
   AI agent platform — human-like agents for WhatsApp & more
   
-  ${chalk.gray('Get started:')}  squidclaw setup
+  ${chalk.gray('Get started:')}  squidclaw hatch
   ${chalk.gray('Help:')}         squidclaw --help
   ${chalk.gray('Docs:')}         https://squidclaw.dev
   `));

package/lib/cli/setup.js

@@ -1,90 +1,110 @@
 /**
  * 🦑 Setup Wizard
- * Interactive first-time setup
+ * One command to install everything — AI, agent, WhatsApp, Telegram
  */
 
 import * as p from '@clack/prompts';
 import chalk from 'chalk';
 import { loadConfig, saveConfig, ensureHome, getHome } from '../core/config.js';
-import { writeFileSync, mkdirSync } from 'fs';
+import { writeFileSync, mkdirSync, existsSync } from 'fs';
 import { join } from 'path';
 import crypto from 'crypto';
 
 export async function setup() {
   console.clear();
-  p.intro(chalk.cyan('🦑 Welcome to Squidclaw!'));
+  console.log(chalk.cyan('\n  ╔══════════════════════════════════════╗'));
+  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();
   ensureHome();
 
-  // Step 1: AI Provider
+  // ═══ Step 1: AI Provider ═══
+  p.note('Step 1 of 5: AI Brain', '🧠');
+
   const provider = await p.select({
     message: 'Choose your AI provider:',
     options: [
       { value: 'anthropic', label: '🟣 Anthropic (Claude)', hint: 'recommended' },
       { value: 'openai', label: '🟢 OpenAI (GPT-4o)' },
-      { value: 'google', label: '🔵 Google (Gemini)', hint: 'free tier available' },
+      { value: 'google', label: '🔵 Google (Gemini)', hint: 'free tier' },
       { value: 'groq', label: '⚡ Groq (Llama)', hint: 'free, very fast' },
       { value: 'cerebras', label: '🧠 Cerebras (Llama)', hint: 'free, fastest' },
-      { value: 'ollama', label: '🏠 Ollama (Local)', hint: 'runs on your machine, no key needed' },
+      { value: 'together', label: '🤝 Together AI' },
+      { value: 'mistral', label: '🇫🇷 Mistral' },
+      { value: 'openrouter', label: '🔀 OpenRouter', hint: 'access all models' },
+      { value: 'ollama', label: '🏠 Ollama (Local)', hint: 'no key needed' },
+      { value: 'lmstudio', label: '🖥️ LM Studio (Local)', hint: 'no key needed' },
     ],
   });
   if (p.isCancel(provider)) return p.cancel('Setup cancelled');
 
-  // Step 2: API Key
   let apiKey = 'local';
-  if (provider !== 'ollama' && provider !== 'lmstudio') {
-    const keyHint = {
-      anthropic: 'Get key at console.anthropic.com',
-      openai: 'Get key at platform.openai.com',
-      google: 'Get key at aistudio.google.dev',
-      groq: 'Get key at console.groq.com (free)',
-      cerebras: 'Get key at cloud.cerebras.ai (free)',
+  if (!['ollama', 'lmstudio'].includes(provider)) {
+    const keyHints = {
+      anthropic: 'console.anthropic.com/keys',
+      openai: 'platform.openai.com/api-keys',
+      google: 'aistudio.google.dev/apikey',
+      groq: 'console.groq.com/keys (free)',
+      cerebras: 'cloud.cerebras.ai (free)',
+      together: 'api.together.ai/settings',
+      mistral: 'console.mistral.ai',
+      openrouter: 'openrouter.ai/keys',
     };
-
     apiKey = await p.text({
-      message: `API Key: ${chalk.gray(keyHint[provider] || '')}`,
-      placeholder: 'sk-...',
+      message: 'API Key:',
+      placeholder: 'Get yours at ' + (keyHints[provider] || 'provider website'),
       validate: (v) => v.length < 5 ? 'Key is too short' : undefined,
     });
     if (p.isCancel(apiKey)) return p.cancel('Setup cancelled');
   }
 
-  // Step 3: Model
-  const modelOptions = {
+  const modelOpts = {
     anthropic: [
-      { value: 'claude-sonnet-4', label: 'Claude Sonnet 4', hint: 'balanced — recommended' },
+      { value: 'claude-sonnet-4', label: 'Claude Sonnet 4', hint: 'balanced ⭐' },
       { value: 'claude-opus-4', label: 'Claude Opus 4', hint: 'most powerful' },
       { value: 'claude-haiku-3.5', label: 'Claude Haiku 3.5', hint: 'fastest, cheapest' },
     ],
     openai: [
-      { value: 'gpt-4o', label: 'GPT-4o', hint: 'recommended' },
+      { value: 'gpt-4o', label: 'GPT-4o', hint: 'recommended ⭐' },
       { value: 'gpt-4o-mini', label: 'GPT-4o Mini', hint: 'cheaper' },
     ],
     google: [
-      { value: 'gemini-2.5-flash', label: 'Gemini 2.5 Flash', hint: 'recommended' },
-      { value: 'gemini-2.5-pro', label: 'Gemini 2.5 Pro', hint: 'most powerful' },
+      { value: 'gemini-2.5-flash', label: 'Gemini 2.5 Flash', hint: 'fast ⭐' },
+      { value: 'gemini-2.5-pro', label: 'Gemini 2.5 Pro', hint: 'powerful' },
     ],
     groq: [
-      { value: 'groq/llama-4-scout', label: 'Llama 4 Scout', hint: 'free, fast' },
+      { value: 'groq/llama-4-scout', label: 'Llama 4 Scout', hint: 'free ⭐' },
       { value: 'groq/llama-4-maverick', label: 'Llama 4 Maverick', hint: 'free, powerful' },
     ],
-    cerebras: [
-      { value: 'cerebras/llama-3.3-70b', label: 'Llama 3.3 70B', hint: 'free, fastest' },
-    ],
-    ollama: [
-      { value: 'ollama/llama3.3', label: 'Llama 3.3 (local)' },
+    cerebras: [{ value: 'cerebras/llama-3.3-70b', label: 'Llama 3.3 70B', hint: 'free ⭐' }],
+    together: [{ value: 'together/llama-4-maverick', label: 'Llama 4 Maverick ⭐' }],
+    mistral: [{ value: 'mistral/mistral-large', label: 'Mistral Large ⭐' }],
+    openrouter: [
+      { value: 'openrouter/anthropic/claude-sonnet-4', label: 'Claude Sonnet 4 ⭐' },
+      { value: 'openrouter/openai/gpt-4o', label: 'GPT-4o' },
     ],
+    ollama: [{ value: 'ollama/llama3.3', label: 'Llama 3.3' }],
+    lmstudio: [{ value: 'lmstudio/default', label: 'Currently loaded model' }],
   };
 
   const model = await p.select({
     message: 'Choose your model:',
-    options: modelOptions[provider] || modelOptions.openai,
+    options: modelOpts[provider] || modelOpts.openai,
   });
   if (p.isCancel(model)) return p.cancel('Setup cancelled');
 
-  // Step 4: Create first agent
-  p.note('Let\'s create your first AI agent');
+  config.ai = config.ai || { providers: {} };
+  config.ai.defaultProvider = provider;
+  config.ai.defaultModel = model;
+  config.ai.providers = config.ai.providers || {};
+  config.ai.providers[provider] = config.ai.providers[provider] || {};
+  config.ai.providers[provider].key = apiKey;
+
+  // ═══ Step 2: Agent ═══
+  p.note('Step 2 of 5: Your Agent', '🤖');
 
   const agentName = await p.text({
     message: 'What should your agent be called?',
@@ -102,125 +122,172 @@ export async function setup() {
   const language = await p.select({
     message: 'Language:',
     options: [
+      { value: 'bilingual', label: '🌍 Bilingual (Arabic + English)', hint: 'auto-detects' },
       { value: 'en', label: '🇬🇧 English' },
       { value: 'ar', label: '🇸🇦 Arabic' },
-      { value: 'bilingual', label: '🌍 Bilingual (Arabic + English)' },
+      { value: 'fr', label: '🇫🇷 French' },
+      { value: 'tr', label: '🇹🇷 Turkish' },
+      { value: 'ur', label: '🇵🇰 Urdu' },
     ],
   });
   if (p.isCancel(language)) return p.cancel('Setup cancelled');
 
   const tone = await p.select({
-    message: 'Tone:',
+    message: 'Personality:',
     options: [
-      { value: 30, label: '👔 Formal' },
-      { value: 50, label: '🤝 Professional but friendly' },
+      { value: 50, label: '🤝 Professional but friendly', hint: 'recommended' },
       { value: 80, label: '😊 Casual and warm' },
+      { value: 30, label: '👔 Formal and polished' },
+      { value: 90, label: '🔥 Fun and sarcastic' },
     ],
   });
   if (p.isCancel(tone)) return p.cancel('Setup cancelled');
 
-  // Step 5: WhatsApp
-  const connectWA = await p.confirm({
-    message: 'Connect WhatsApp now?',
-    initialValue: true,
-  });
-  if (p.isCancel(connectWA)) return p.cancel('Setup cancelled');
-
-  // Save config
-  config.ai.defaultProvider = provider;
-  config.ai.defaultModel = model;
-  config.ai.providers[provider].key = apiKey;
-
-  if (connectWA) {
-    config.channels.whatsapp.enabled = true;
-  }
-
-  saveConfig(config);
-
-  // Create agent files
   const agentId = crypto.randomUUID().slice(0, 8);
   const agentDir = join(getHome(), 'agents', agentId);
   mkdirSync(join(agentDir, 'memory'), { recursive: true });
+  mkdirSync(join(agentDir, 'knowledge'), { recursive: true });
 
-  const soul = `# ${agentName}
+  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.' };
 
-## Who I Am
-I'm ${agentName}. ${agentPurpose || 'I\'m a helpful AI assistant.'}
+  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';
 
-## How I Speak
-- Language: ${language === 'ar' ? 'Arabic' : language === 'bilingual' ? 'Bilingual — I match whatever language the person uses' : 'English'}
-- Tone: ${tone > 60 ? 'Casual and friendly. I text like a real person.' : tone > 30 ? 'Professional but warm. Friendly without being too casual.' : 'Formal and polished. I maintain professionalism.'}
-- Platform: WhatsApp — short messages, natural, human-like
-- I use emojis naturally but don't overdo it
+  writeFileSync(join(agentDir, 'SOUL.md'), soul);
+  writeFileSync(join(agentDir, 'IDENTITY.md'), '# ' + agentName + '\n- Name: ' + agentName + '\n- Language: ' + language + '\n- Emoji: 🦑\n');
+  writeFileSync(join(agentDir, 'MEMORY.md'), '# Memory\n\n_Learning about people._\n');
+  writeFileSync(join(agentDir, 'RULES.md'), '# Rules\n\n1. Be helpful, be human, be honest\n2. Keep messages short\n3. Don\'t make things up\n4. Match customer language\n5. Respect privacy\n');
+  writeFileSync(join(agentDir, 'BEHAVIOR.md'), JSON.stringify({ splitMessages: true, maxChunkLength: 200, reactBeforeReply: true, reactOnlyEndings: true, autoDetectLanguage: true, avoidPhrases: ["Is there anything else I can help with?", "I'd be happy to help!", "Great question!", "As an AI"], handoff: { enabled: false }, heartbeat: '30m' }, null, 2));
 
-## What I Do
-${agentPurpose || 'Help people with their questions and tasks.'}
+  const manifest = { id: agentId, name: agentName, language, tone, model, status: 'active', createdAt: new Date().toISOString() };
 
-## What I Never Do
-- Say "As an AI" or "I'd be happy to help" or "Great question!"
-- Send walls of text — I keep it short and conversational
-- Make things up when I don't know — I say "let me check" instead
-`;
+  // ═══ Step 3: WhatsApp ═══
+  p.note('Step 3 of 5: WhatsApp', '📱');
 
-  writeFileSync(join(agentDir, 'SOUL.md'), soul);
-  writeFileSync(join(agentDir, 'IDENTITY.md'), `# ${agentName}\n- Name: ${agentName}\n- Language: ${language}\n- Emoji: 🦑\n`);
-  writeFileSync(join(agentDir, 'MEMORY.md'), `# ${agentName}'s Memory\n\n_Learning about people and building relationships._\n`);
-  writeFileSync(join(agentDir, 'RULES.md'), `# Rules\n\n1. Be helpful, be human, be honest\n2. Keep messages short — this is WhatsApp, not email\n3. If unsure, say so instead of making things up\n`);
-  writeFileSync(join(agentDir, 'BEHAVIOR.md'), JSON.stringify({
-    splitMessages: true,
-    maxChunkLength: 200,
-    reactBeforeReply: true,
-    reactOnlyEndings: true,
-    autoDetectLanguage: true,
-    avoidPhrases: [
-      "Is there anything else I can help with?",
-      "I'd be happy to help!",
-      "Great question!",
-      "As an AI",
+  const connectWA = await p.select({
+    message: 'Connect WhatsApp?',
+    options: [
+      { value: 'pair', label: '📲 Pairing Code (easier)', hint: 'enter phone number' },
+      { value: 'qr', label: '📷 QR Code', hint: 'scan with phone' },
+      { value: 'skip', label: '⏭️  Skip for now' },
     ],
-    handoff: { enabled: false },
-    heartbeat: '30m',
-  }, null, 2));
-
-  // Save agent to a manifest file for the engine to pick up
-  const manifest = {
-    id: agentId,
-    name: agentName,
-    soul,
-    language,
-    tone,
-    model,
-    status: 'active',
-    createdAt: new Date().toISOString(),
-  };
-  writeFileSync(join(agentDir, 'agent.json'), JSON.stringify(manifest, null, 2));
-
-  p.note(`Agent "${agentName}" created in ${agentDir}`);
+  });
+  if (p.isCancel(connectWA)) return p.cancel('Setup cancelled');
 
-  // WhatsApp pairing
-  if (connectWA) {
-    const phone = await p.text({
-      message: '📱 Your WhatsApp phone number:',
+  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';
+    }
+  } else if (connectWA === 'qr') {
+    manifest.whatsappLoginMethod = 'qr';
+  }
+
+  if (connectWA !== 'skip') {
+    config.channels = config.channels || {};
+    config.channels.whatsapp = config.channels.whatsapp || {};
+    config.channels.whatsapp.enabled = true;
+  }
+
+  // ═══ Step 4: Telegram ═══
+  p.note('Step 4 of 5: Telegram', '✈️');
+
+  const connectTG = await p.confirm({ message: 'Connect Telegram bot?', initialValue: false });
+  if (p.isCancel(connectTG)) return p.cancel('Setup cancelled');
+
+  if (connectTG) {
+    console.log(chalk.gray('\n  To create a Telegram bot:\n  1. Open @BotFather on Telegram\n  2. Send /newbot\n  3. Copy the token\n'));
+    const tgToken = await p.text({
+      message: 'Telegram Bot Token:',
+      placeholder: '123456789:ABCdefGhIjKlMnOpQrStUvWxYz',
+      validate: (v) => !v.includes(':') ? 'Invalid token (should contain ":")' : undefined,
+    });
+    if (!p.isCancel(tgToken)) {
+      manifest.telegramToken = tgToken;
+      config.channels = config.channels || {};
+      config.channels.telegram = { enabled: true };
+    }
+  }
+
+  // ═══ Step 5: Knowledge ═══
+  p.note('Step 5 of 5: Knowledge (optional)', '📚');
+
+  const addKnowledge = await p.confirm({
+    message: 'Upload docs now? (menu, FAQ, etc — you can add later too)',
+    initialValue: false,
+  });
+  if (p.isCancel(addKnowledge)) return p.cancel('Setup cancelled');
+
+  const knowledgeFiles = [];
+  if (addKnowledge) {
+    let addMore = true;
+    while (addMore) {
+      const ft = await p.select({
+        message: 'What to add?',
+        options: [
+          { value: 'file', label: '📄 Local file (PDF, TXT, MD)' },
+          { value: 'url', label: '🌐 Website URL' },
+          { value: 'text', label: '✏️  Type it directly' },
+        ],
+      });
+      if (p.isCancel(ft)) break;
 
-    if (!p.isCancel(phone)) {
-      p.note(`WhatsApp will connect when you run ${chalk.cyan('squidclaw start')}\nThen run ${chalk.cyan('squidclaw channels login whatsapp')} to link your account.`);
-      
-      // Save phone to agent manifest
-      manifest.whatsappNumber = phone.replace(/[^0-9+]/g, '');
-      writeFileSync(join(agentDir, 'agent.json'), JSON.stringify(manifest, null, 2));
+      if (ft === 'file') {
+        const fp = await p.text({ message: 'File path:', placeholder: '/path/to/menu.pdf', validate: (v) => !existsSync(v) ? 'File not found' : undefined });
+        if (!p.isCancel(fp)) knowledgeFiles.push({ type: 'file', path: fp });
+      } else if (ft === 'url') {
+        const url = await p.text({ message: 'URL:', placeholder: 'https://mysite.com/menu', validate: (v) => !v.startsWith('http') ? 'Enter a valid URL' : undefined });
+        if (!p.isCancel(url)) knowledgeFiles.push({ type: 'url', path: url });
+      } else {
+        const txt = await p.text({ message: 'Paste your text:', placeholder: 'Business hours: 9am-11pm...' });
+        if (!p.isCancel(txt)) knowledgeFiles.push({ type: 'text', content: txt });
+      }
+
+      const more = await p.confirm({ message: 'Add more?', initialValue: false });
+      addMore = !p.isCancel(more) && more;
     }
   }
 
-  // Done!
-  p.outro(chalk.green(`
-🦑 Setup complete!
+  // ═══ Save everything ═══
+  saveConfig(config);
+  writeFileSync(join(agentDir, 'agent.json'), JSON.stringify(manifest, null, 2));
+  if (knowledgeFiles.length > 0) {
+    writeFileSync(join(agentDir, 'knowledge', 'pending.json'), JSON.stringify(knowledgeFiles, null, 2));
+  }
+
+  // ═══ Summary ═══
+  const waStatus = connectWA === 'pair' ? 'Pairing code (on start)' : connectWA === 'qr' ? 'QR code (on start)' : 'skipped';
+  const tgStatus = connectTG ? 'bot ready' : 'skipped';
 
-  Start:   ${chalk.cyan('squidclaw start')}
-  Status:  ${chalk.cyan('squidclaw status')}
-  Chat:    ${chalk.cyan(`squidclaw agent chat ${agentId}`)}
-  Docs:    ${chalk.cyan('https://squidclaw.dev')}
-`));
+  console.log(chalk.green('\n  ════════════════════════════════════'));
+  console.log(chalk.green('  ✅ Setup Complete!'));
+  console.log(chalk.green('  ════════════════════════════════════\n'));
+  console.log('  ' + chalk.bold('Agent:') + '     ' + agentName + ' (' + agentId + ')');
+  console.log('  ' + chalk.bold('Brain:') + '     ' + model + ' via ' + provider);
+  console.log('  ' + chalk.bold('Language:') + '  ' + (langText[language] || language));
+  console.log('  ' + chalk.bold('WhatsApp:') + '  ' + waStatus);
+  console.log('  ' + chalk.bold('Telegram:') + '  ' + tgStatus);
+  if (knowledgeFiles.length > 0) console.log('  ' + chalk.bold('Knowledge:') + '  ' + knowledgeFiles.length + ' items queued');
+  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 knowledge upload') + '  — add documents');
+  console.log('     ' + chalk.cyan('squidclaw help') + '             — all commands');
+  console.log('\n  ════════════════════════════════════\n');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "squidclaw",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "🦑 AI agent platform — human-like agents for WhatsApp, Telegram & more",
   "main": "lib/engine.js",
   "bin": {