alvin-bot 4.4.1

package/docs/mcp.example.json

@@ -0,0 +1,16 @@
+{
+  "servers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
+      "env": {}
+    },
+    "brave-search": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
+      "env": {
+        "BRAVE_API_KEY": "your-key-here"
+      }
+    }
+  }
+}

package/docs/tools.example.json

@@ -0,0 +1,33 @@
+{
+  "tools": [
+    {
+      "name": "server_health",
+      "description": "Check server health",
+      "type": "http",
+      "url": "https://api.example.com/health",
+      "method": "GET"
+    },
+    {
+      "name": "deploy",
+      "description": "Deploy the application",
+      "command": "ssh server 'cd /app && git pull && pm2 restart all'",
+      "timeout": 60000
+    },
+    {
+      "name": "quick_note",
+      "description": "Append a note to a file",
+      "command": "echo '{{text}}' >> ~/notes.txt",
+      "parameters": {
+        "text": {
+          "type": "string",
+          "description": "Note text to append"
+        }
+      }
+    },
+    {
+      "name": "disk_usage",
+      "description": "Check disk usage",
+      "command": "df -h / | tail -1"
+    }
+  ]
+}

package/install.sh

@@ -0,0 +1,165 @@
+#!/usr/bin/env bash
+# ─────────────────────────────────────────────────────────────
+# Alvin Bot — One-Line Installer
+# Usage: curl -fsSL https://install.alvin-bot.dev | bash
+# ─────────────────────────────────────────────────────────────
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+BOLD='\033[1m'
+NC='\033[0m' # No Color
+
+INSTALL_DIR="$HOME/.alvin-bot"
+REPO_URL="https://github.com/alvbln/alvin-bot.git"
+BIN_LINK="/usr/local/bin/alvin-bot"
+MIN_NODE_VERSION=18
+
+# ─── Helpers ────────────────────────────────────────────────
+
+info()  { echo -e "${BLUE}ℹ${NC}  $*"; }
+ok()    { echo -e "${GREEN}✔${NC}  $*"; }
+warn()  { echo -e "${YELLOW}⚠${NC}  $*"; }
+fail()  { echo -e "${RED}✘${NC}  $*"; exit 1; }
+
+# ─── OS Detection ──────────────────────────────────────────
+
+detect_os() {
+  case "$(uname -s)" in
+    Darwin*)  OS="macOS" ;;
+    Linux*)
+      if grep -qi microsoft /proc/version 2>/dev/null; then
+        OS="WSL"
+      else
+        OS="Linux"
+      fi
+      ;;
+    *)        fail "Unsupported OS: $(uname -s). Use macOS, Linux, or WSL." ;;
+  esac
+  ok "Detected OS: ${BOLD}$OS${NC}"
+}
+
+# ─── Dependency Checks ─────────────────────────────────────
+
+check_git() {
+  if ! command -v git &>/dev/null; then
+    fail "Git is not installed. Please install git first:
+    macOS:  xcode-select --install
+    Linux:  sudo apt install git  (or yum/pacman equivalent)
+    WSL:    sudo apt install git"
+  fi
+  ok "Git found: $(git --version)"
+}
+
+check_node() {
+  if ! command -v node &>/dev/null; then
+    fail "Node.js is not installed (>= $MIN_NODE_VERSION required).
+    Install via: https://nodejs.org or
+    macOS:  brew install node@22
+    Linux:  curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs"
+  fi
+
+  local node_ver
+  node_ver=$(node -v | sed 's/^v//' | cut -d. -f1)
+  if [ "$node_ver" -lt "$MIN_NODE_VERSION" ]; then
+    fail "Node.js >= $MIN_NODE_VERSION required, but found v$(node -v). Please upgrade."
+  fi
+  ok "Node.js found: $(node -v)"
+}
+
+check_npm() {
+  if ! command -v npm &>/dev/null; then
+    fail "npm is not installed. It should come with Node.js — please reinstall Node."
+  fi
+  ok "npm found: $(npm -v)"
+}
+
+# ─── Installation ──────────────────────────────────────────
+
+install_bot() {
+  if [ -d "$INSTALL_DIR" ]; then
+    warn "Existing installation found at $INSTALL_DIR"
+    info "Updating..."
+    cd "$INSTALL_DIR"
+    git pull --ff-only || fail "Git pull failed. Resolve conflicts manually in $INSTALL_DIR"
+  else
+    info "Cloning alvin-bot to $INSTALL_DIR..."
+    git clone --depth 1 "$REPO_URL" "$INSTALL_DIR" || fail "Git clone failed. Check your network."
+    cd "$INSTALL_DIR"
+  fi
+
+  info "Installing production dependencies..."
+  npm install --omit=dev || fail "npm install failed."
+
+  info "Building TypeScript..."
+  npm run build || fail "Build failed."
+
+  ok "Installation complete!"
+}
+
+create_symlink() {
+  local bin_dir
+  bin_dir=$(dirname "$BIN_LINK")
+
+  # Make CLI executable
+  chmod +x "$INSTALL_DIR/bin/cli.js"
+
+  # Try /usr/local/bin first, fall back to ~/.local/bin
+  if [ -w "$bin_dir" ] || [ -w "$BIN_LINK" ] 2>/dev/null; then
+    ln -sf "$INSTALL_DIR/bin/cli.js" "$BIN_LINK"
+    ok "Symlinked: alvin-bot → $BIN_LINK"
+  elif command -v sudo &>/dev/null; then
+    info "Creating symlink (requires sudo)..."
+    sudo ln -sf "$INSTALL_DIR/bin/cli.js" "$BIN_LINK"
+    ok "Symlinked: alvin-bot → $BIN_LINK"
+  else
+    # Fallback: ~/.local/bin
+    local fallback="$HOME/.local/bin"
+    mkdir -p "$fallback"
+    ln -sf "$INSTALL_DIR/bin/cli.js" "$fallback/alvin-bot"
+    warn "Symlinked to $fallback/alvin-bot (add to PATH if not already)"
+    warn "  export PATH=\"$fallback:\$PATH\""
+    BIN_LINK="$fallback/alvin-bot"
+  fi
+}
+
+# ─── Main ──────────────────────────────────────────────────
+
+main() {
+  echo ""
+  echo -e "${BOLD}🦊 Alvin Bot Installer${NC}"
+  echo -e "─────────────────────────────────────"
+  echo ""
+
+  detect_os
+  check_git
+  check_node
+  check_npm
+
+  echo ""
+  install_bot
+  create_symlink
+
+  echo ""
+  echo -e "─────────────────────────────────────"
+  echo -e "${GREEN}${BOLD}🎉 Alvin Bot installed successfully!${NC}"
+  echo ""
+  echo -e "  Next steps:"
+  echo -e "    ${BOLD}alvin-bot setup${NC}    — Configure your bot (interactive)"
+  echo -e "    ${BOLD}alvin-bot start${NC}    — Start the bot"
+  echo -e "    ${BOLD}alvin-bot --help${NC}   — Show all commands"
+  echo ""
+  echo -e "  Installed to: ${BLUE}$INSTALL_DIR${NC}"
+  echo -e "  Command:      ${BLUE}$BIN_LINK${NC}"
+  echo ""
+
+  # Run interactive setup
+  info "Starting setup wizard..."
+  echo ""
+  alvin-bot setup || warn "Setup skipped. Run 'alvin-bot setup' later to configure."
+}
+
+main "$@"

package/package.json

@@ -0,0 +1,190 @@
+{
+  "name": "alvin-bot",
+  "version": "4.4.1",
+  "description": "Alvin Bot — Your personal AI agent on Telegram, WhatsApp, Discord, Signal, and Web.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "alvin-bot": "bin/cli.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "setup": "node bin/cli.js setup",
+    "electron:compile": "tsc -p electron/tsconfig.json",
+    "electron:dev": "npm run electron:compile && electron .",
+    "electron:build": "npm run build && npm run electron:compile && electron-builder --publish never",
+    "electron:pack": "npm run build && npm run electron:compile && electron-builder --dir --publish never",
+    "electron:build:full": "bash scripts/electron-build.sh"
+  },
+  "build": {
+    "appId": "com.alvinbot.app",
+    "productName": "Alvin Bot",
+    "directories": {
+      "output": "release"
+    },
+    "extraResources": [
+      {
+        "from": "dist",
+        "to": "app/dist"
+      },
+      {
+        "from": "web",
+        "to": "app/web"
+      },
+      {
+        "from": "docs",
+        "to": "app/docs"
+      },
+      {
+        "from": "plugins",
+        "to": "app/plugins"
+      },
+      {
+        "from": "skills",
+        "to": "app/skills"
+      },
+      {
+        "from": ".prod-node-modules",
+        "to": "app/node_modules"
+      },
+      {
+        "from": "build",
+        "to": "build"
+      },
+      {
+        "from": "package.json",
+        "to": "app/package.json"
+      }
+    ],
+    "mac": {
+      "target": [
+        {
+          "target": "dmg",
+          "arch": [
+            "arm64"
+          ]
+        }
+      ],
+      "icon": "build/icon.png",
+      "category": "public.app-category.utilities"
+    },
+    "win": {
+      "target": "nsis",
+      "icon": "build/icon.ico"
+    },
+    "nsis": {
+      "oneClick": false,
+      "allowToChangeInstallationDirectory": true
+    },
+    "linux": {
+      "target": [
+        "AppImage",
+        "deb"
+      ],
+      "icon": "build/icon.png",
+      "category": "Utility"
+    },
+    "publish": {
+      "provider": "github",
+      "owner": "alvbln",
+      "repo": "alvin-bot"
+    },
+    "asar": false,
+    "files": [
+      "electron/dist/**/*",
+      "dist/**/*",
+      "web/**/*",
+      "plugins/**/*",
+      "skills/**/*",
+      "docs/*.md",
+      "docs/prompts/**/*",
+      "!docs/memory/**",
+      "!docs/MEMORY.md",
+      "!docs/users/**",
+      "!docs/whatsapp-groups.json",
+      "!docs/cron-jobs.json",
+      "bin/**/*",
+      "package.json",
+      "SOUL.md",
+      "alvin-bot.config.example.json",
+      ".env.example",
+      "CHANGELOG.md",
+      "README.md",
+      "LICENSE",
+      "!src",
+      "!data",
+      "!backups",
+      "!.wwebjs_cache",
+      "!.git",
+      "!.github",
+      "!scripts",
+      "!release",
+      "!.prod-node-modules",
+      "!.electron-prod",
+      "!CLAUDE.md",
+      "!telegram-agent-setup-prompt.md",
+      "!**/*.log",
+      "!**/*.bak"
+    ],
+    "afterPack": "./electron/afterPack.cjs"
+  },
+  "keywords": [
+    "telegram",
+    "bot",
+    "ai",
+    "claude",
+    "agent",
+    "llm",
+    "multi-model",
+    "gpt",
+    "gemini",
+    "nvidia",
+    "self-hosted",
+    "autonomous",
+    "whatsapp",
+    "discord",
+    "signal",
+    "openai",
+    "groq",
+    "chatbot",
+    "assistant",
+    "electron"
+  ],
+  "author": "alvbln",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alvbln/Alvin-Bot.git"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.92",
+    "@hapi/boom": "^10.0.1",
+    "@slack/bolt": "^4.6.0",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "@whiskeysockets/baileys": "^6.7.21",
+    "dotenv": "^16.4.0",
+    "electron-updater": "^6.8.3",
+    "grammy": "^1.30.0",
+    "node-edge-tts": "^1.2.10",
+    "pino": "^10.3.1",
+    "playwright": "^1.58.2",
+    "typescript": "^5.9.3",
+    "whatsapp-web.js": "^1.34.6",
+    "ws": "^8.19.0"
+  },
+  "devDependencies": {
+    "electron": "^35.7.5",
+    "electron-builder": "^26.8.1",
+    "tsx": "^4.19.0"
+  },
+  "homepage": "https://github.com/alvbln/Alvin-Bot",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bugs": {
+    "url": "https://github.com/alvbln/alvin-bot/issues"
+  }
+}