@aliwey/bmo 2.0.0

package/README.md

@@ -0,0 +1,90 @@
+# BMO — OpenCode AI Coding Assistant
+
+BMO is a unified, self-contained AI coding assistant with Telegram, CLI, and Webchat interfaces. It connects to a local [OpenCode](https://github.com/opencode-ai/opencode) instance and extends it with persistent memory, tool access, custom agents, and a decentralized peer-to-peer Agent Discovery Protocol (BFP).
+
+---
+
+## 🚀 Installation & Setup
+
+BMO is published as a global Node/npm command-line tool. The installer automatically downloads a minimal embedded Python environment, installs python dependencies, and sets up everything required.
+
+### 1. Install Globally via npm
+```bash
+npm install -g @aliwey/bmo
+```
+
+### 2. Run the Configuration Wizard
+Configure your Telegram Bot Father token, admin Telegram user ID, model settings, and peer registry:
+```bash
+bmo init
+```
+This generates your configuration file at `~/.bmo/.env`.
+
+---
+
+## ⚡ Quick Start
+
+### 🤖 Start the Bot & CLI
+To launch the Telegram bot polling and the interactive terminal TUI:
+```bash
+bmo
+```
+*Note: If your local OpenCode instance is not running, BMO will automatically attempt to launch it.*
+
+### 🌐 Launch the Web Chat Interface
+Starts the unified Node.js/Express Web Chat and opens a secure public Cloudflare Tunnel so you can chat from any web browser:
+```bash
+bmo web
+```
+
+### 📡 Go Online (Peer Relay)
+Start a BFP (BMO Friendship Protocol) peer relay node to make your agent discoverable by other BMO peers on the registry:
+```bash
+bmo relay
+```
+*   To run privately without listing on the public registry: `bmo relay --private`
+*   To stop the relay background services: `bmo relay --stop`
+
+---
+
+## 🛠️ CLI Commands & Subcommands
+
+```bash
+bmo [command] [options]
+```
+
+| Command | Option | Description |
+|---|---|---|
+| `bmo` | — | Starts the Telegram bot & CLI TUI |
+| `bmo init` | — | Runs the interactive setup wizard |
+| `bmo web` | — | Starts Express Webchat + Cloudflare tunnel |
+| `bmo relay` | `[--private] [--stop]` | Starts/stops the BFP capability relay |
+| `bmo --version` | — | Prints the package version |
+| `bmo --update` | — | Automatically pulls and applies the latest updates |
+
+---
+
+## ⚙️ Configuration & Storage
+
+All user configurations, chat databases, and logs are kept isolated in the user's home directory under `~/.bmo/`:
+
+*   **`~/.bmo/.env`** — Bot tokens, model configurations, and ports.
+*   **`~/.bmo/data/bot.db`** — Shared SQLite database (WAL mode) containing all sessions, messages, memory, and custom agents.
+*   **`~/.bmo/logs/`** — Log files for the bot, webchat, and tunnel.
+
+---
+
+## 👥 Telegram interface
+
+Use the persistent keyboard controls at the bottom of the chat, or the inline control menu (`/menu` command) to:
+- **🆕 New / 💾 Save / 📂 Load** sessions
+- **🤖 Choose Model** dynamically (e.g. OpenAI, Anthropic, DeepSeek, or local)
+- **⚡ Operation Modes**: `plan` (outline only), `ask` (clarifying questions first), or `execute` (write code and run commands)
+- **🎭 Agents & 🛠️ Skills**: Enable custom or generated personas and load specialized capabilities
+- **🌐 Chat on Web**: Dynamically launch a cloudflared-tunneled web interface directly from Telegram
+
+---
+
+## 📄 License
+
+MIT License. Developed by Aliwey.

package/bin/bmo.js

@@ -0,0 +1,188 @@
+#!/usr/bin/env node
+/**
+ * BMO CLI entry point — @aliwey/bmo
+ * Routes subcommands and manages OpenCode lifecycle.
+ */
+
+'use strict';
+
+const { spawn, execSync } = require('child_process');
+const net = require('net');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+const PKG_DIR = path.join(__dirname, '..');
+const BMO_HOME = process.env.BMO_HOME || path.join(os.homedir(), '.bmo');
+const VERSION = require('../package.json').version;
+
+// ── Helpers ─────────────────────────────────────────────────────────────────
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+async function isPortOpen(port, host = '127.0.0.1') {
+  return new Promise(resolve => {
+    const s = net.createConnection({ port, host });
+    s.setTimeout(500);
+    s.on('connect', () => { s.destroy(); resolve(true); });
+    s.on('timeout', () => { s.destroy(); resolve(false); });
+    s.on('error', () => resolve(false));
+  });
+}
+
+/** Resolve the embedded or system Python executable */
+function getPython() {
+  const embeddedWin = path.join(BMO_HOME, 'python', 'python.exe');
+  const embeddedUnix = path.join(BMO_HOME, 'python', 'bin', 'python3');
+  if (fs.existsSync(embeddedWin)) return embeddedWin;
+  if (fs.existsSync(embeddedUnix)) return embeddedUnix;
+  // Fall back to system Python
+  for (const cmd of ['python3', 'python']) {
+    try { execSync(`${cmd} --version`, { stdio: 'ignore' }); return cmd; } catch {}
+  }
+  console.error('❌ Python not found. Run: bmo init');
+  process.exit(1);
+}
+
+/** Start OpenCode if not already running. Returns the child if we own it. */
+async function ensureOpenCode() {
+  const port = parseInt(process.env.OPENCODE_PORT || '4800');
+  if (await isPortOpen(port)) {
+    process.stdout.write(`✓ OpenCode already running on port ${port}\n`);
+    return null; // don't own it
+  }
+
+  // Check opencode is installed
+  try { execSync('opencode --version', { stdio: 'ignore' }); }
+  catch {
+    console.error('❌ opencode not found. Installing...');
+    try { execSync('npm install -g opencode-ai', { stdio: 'inherit' }); }
+    catch { console.error('❌ Could not install opencode-ai. Please run: npm install -g opencode-ai'); process.exit(1); }
+  }
+
+  process.stdout.write(`⏳ Starting OpenCode server on port ${port}...\n`);
+  const child = spawn('opencode', ['serve', '--port', String(port)], {
+    detached: false,
+    stdio: 'ignore',
+    cwd: PKG_DIR,
+  });
+
+  child.on('error', err => {
+    console.error(`❌ Failed to start OpenCode: ${err.message}`);
+    process.exit(1);
+  });
+
+  // Wait up to 15s for port to open
+  for (let i = 0; i < 30; i++) {
+    await sleep(500);
+    if (await isPortOpen(port)) {
+      process.stdout.write(`✓ OpenCode server ready\n`);
+      return child;
+    }
+  }
+  console.error('❌ OpenCode server did not start in time.');
+  child.kill();
+  process.exit(1);
+}
+
+// ── Command routing ──────────────────────────────────────────────────────────
+
+const [,, cmd, ...args] = process.argv;
+
+(async () => {
+  // ── bmo --version ─────────────────────────────────────────────────────
+  if (cmd === '--version' || cmd === '-v') {
+    console.log(`@aliwey/bmo v${VERSION}`);
+    process.exit(0);
+  }
+
+  // ── bmo --help ───────────────────────────────────────────────────────
+  if (cmd === '--help' || cmd === '-h' || cmd === 'help') {
+    const PKG_JSON = require('../package.json');
+    const BMO_HOME_DISPLAY = process.env.BMO_HOME || path.join(os.homedir(), '.bmo');
+    console.log(`
+@aliwey/bmo v${PKG_JSON.version} — AI coding assistant with Telegram, CLI & Web sync
+
+Usage:
+  bmo                  Start the BMO CLI (auto-starts OpenCode if needed)
+  bmo init             Run the setup wizard (creates ~/.bmo/.env)
+  bmo web              Start webchat + Cloudflare tunnel, print public URL
+  bmo relay            Start BFP relay + register with discovery registry
+  bmo relay --stop     Stop relay + deregister
+  bmo relay --private  Start relay without registering (private mode)
+  bmo --version        Show version
+  bmo --update         Update to latest version
+  bmo --update <ver>   Update to a specific version
+  bmo --help           Show this help
+
+Data lives in: ${BMO_HOME_DISPLAY}
+`);
+    process.exit(0);
+  }
+
+  // ── bmo --update [version] ────────────────────────────────────────────────
+  if (cmd === '--update') {
+    const ver = args[0] ? `@${args[0]}` : '@latest';
+    console.log(`🔄 Updating to @aliwey/bmo${ver}...`);
+    try {
+      execSync(`npm install -g @aliwey/bmo${ver}`, { stdio: 'inherit' });
+    } catch {
+      console.error('❌ Update failed. Try manually: npm install -g @aliwey/bmo');
+      process.exit(1);
+    }
+    process.exit(0);
+  }
+
+  // ── bmo init ──────────────────────────────────────────────────────────────
+  if (cmd === 'init') {
+    require('../scripts/bmo_init.js');
+    return;
+  }
+
+  // ── bmo web ───────────────────────────────────────────────────────────────
+  if (cmd === 'web') {
+    require('../scripts/web_cmd.js');
+    return;
+  }
+
+  // ── bmo relay [--private|--stop] ──────────────────────────────────────────
+  if (cmd === 'relay') {
+    process.argv = [process.argv[0], process.argv[1], ...args]; // pass flags
+    require('../scripts/relay_cmd.js');
+    return;
+  }
+
+  // ── bmo (default: CLI) ────────────────────────────────────────────────────
+  const openCodeChild = await ensureOpenCode();
+
+  // Clean up owned OpenCode on exit
+  if (openCodeChild) {
+    const cleanup = () => { try { openCodeChild.kill(); } catch {} };
+    process.on('exit', cleanup);
+    process.on('SIGINT', () => { cleanup(); process.exit(0); });
+    process.on('SIGTERM', () => { cleanup(); process.exit(0); });
+  }
+
+  // Launch BMO Python CLI — exactly like running `python cli.py`
+  const python = getPython();
+  const cliScript = path.join(PKG_DIR, 'cli.py');
+
+  const bmo = spawn(python, [cliScript], {
+    stdio: 'inherit',
+    cwd: PKG_DIR,
+    env: {
+      ...process.env,
+      BMO_HOME,
+      PYTHONUNBUFFERED: '1',
+    },
+  });
+
+  bmo.on('error', err => {
+    console.error(`❌ Failed to start BMO: ${err.message}`);
+    process.exit(1);
+  });
+
+  bmo.on('exit', code => process.exit(code ?? 0));
+})();