imtoagent 0.3.4 → 0.3.5

package/bin/imtoagent-real

@@ -1,14 +1,14 @@
 #!/usr/bin/env bun
 // ================================================================
-// imtoagent CLI — 全局命令入口
+// imtoagent CLI — global command entry point
 // ================================================================
-// npm install -g imtoagent 后可用：
-//   imtoagent setup    — 交互式配置向导
-//   imtoagent start    — 后台启动网关
-//   imtoagent stop     — 停止网关
-//   imtoagent status   — 查看运行状态
-//   imtoagent restore  — 热重载恢复
-//   imtoagent daemon   — 前台守护模式（自动重启 + 日志）
+// Available after npm install -g imtoagent:
+//   imtoagent setup    — interactive setup wizard
+//   imtoagent start    — start gateway in background
+//   imtoagent stop     — stop gateway
+//   imtoagent status   — check running status
+//   imtoagent restore  — hot reload
+//   imtoagent daemon   — foreground daemon (auto-restart + logs)
 // ================================================================
 
 import * as fs from 'fs';
@@ -18,7 +18,7 @@ import { getDataDir } from '../modules/utils/paths';
 const PID_FILE = '/tmp/imtoagent.pid';
 
 // ================================================================
-// 命令分发
+// Command dispatch
 // ================================================================
 const command = process.argv[2];
 
@@ -42,19 +42,19 @@ switch (command) {
     await cmdDaemon();
     break;
   case undefined: {
-    // 无命令 → 没完成 setup 自动进向导，已完成显示帮助
+    // No command → auto-enter setup if not configured, show help otherwise
     const dataDir = getDataDir();
     const configPath = path.join(dataDir, 'config.json');
     let needsSetup = !fs.existsSync(configPath);
     if (!needsSetup) {
       try {
         const raw = fs.readFileSync(configPath, 'utf-8');
-        // 如果配置里还有 YOUR_ 占位符，说明还没完成 setup
+        // If config still has YOUR_ placeholders, setup is incomplete
         needsSetup = /YOUR_[A-Z_]+/.test(raw);
       } catch { needsSetup = true; }
     }
     if (needsSetup) {
-      console.log('👋 欢迎使用 imtoagent，请先完成初始配置\n');
+      console.log('👋 Welcome to imtoagent! Please run setup first.\n');
       await cmdSetup();
     } else {
       printHelp();
@@ -67,7 +67,7 @@ switch (command) {
     printHelp();
     break;
   default:
-    console.error(`❌ 未知命令: ${command}`);
+    console.error(`❌ Unknown command: ${command}`);
     printHelp();
     process.exit(1);
 }
@@ -77,22 +77,22 @@ switch (command) {
 // ================================================================
 function printHelp() {
   console.log(`
-imtoagent — IM ↔ Agent 统一网关
+imtoagent — IM ↔ Agent Unified Gateway
 
-用法:
-  imtoagent setup     交互式配置向导
-  imtoagent start     后台启动网关
-  imtoagent stop      停止网关
-  imtoagent status    查看运行状态
-  imtoagent restore   热重载恢复
-  imtoagent daemon    前台守护模式（自动重启 + 日志，适合 launchd/systemd 托管）
+Usage:
+  imtoagent setup     Interactive setup wizard
+  imtoagent start     Start gateway in background
+  imtoagent stop      Stop gateway
+  imtoagent status    Check running status
+  imtoagent restore   Hot reload
+  imtoagent daemon    Foreground daemon (auto-restart + logs, for launchd/systemd)
 
-数据目录: ${getDataDir()}
+Data directory: ${getDataDir()}
 `);
 }
 
 // ================================================================
-// setup — 交互式向导
+// setup — interactive wizard
 // ================================================================
 async function cmdSetup() {
   const { runSetupWizard } = await import('../modules/cli/setup');
@@ -100,32 +100,32 @@ async function cmdSetup() {
 }
 
 // ================================================================
-// start — 后台启动
+// start — launch in background
 // ================================================================
 async function cmdStart() {
-  // 检查是否已在运行
+  // Check if already running
   if (fs.existsSync(PID_FILE)) {
     const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8').trim());
     try {
       process.kill(pid, 0);
-      console.error(`❌ 网关已在运行 (PID=${pid})`);
-      console.error(`   运行 "imtoagent stop" 先停止`);
+      console.error(`❌ Gateway already running (PID=${pid})`);
+      console.error(`   Run "imtoagent stop" to stop first`);
       process.exit(1);
     } catch {
-      // 旧 PID 文件残留，清理
+      // Stale PID file, clean up
       fs.unlinkSync(PID_FILE);
     }
   }
 
-  // 检查配置是否存在
+  // Check if config exists
   const dataDir = getDataDir();
   const configPath = path.join(dataDir, 'config.json');
   if (!fs.existsSync(configPath)) {
-    console.error('❌ 未找到配置文件，请先运行 "imtoagent setup"');
+    console.error('❌ No config file found. Please run "imtoagent setup" first');
     process.exit(1);
   }
 
-  // 检查配置的后端是否已安装
+  // Check if configured backends are installed
   try {
     const { checkBackend } = await import('../modules/utils/backend-check');
     const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
@@ -139,22 +139,22 @@ async function cmdStart() {
       }
     }
     if (missingBackends.length > 0) {
-      console.error(`\n⚠️  以下后端已配置但未安装，网关启动后发消息会报错：`);
+      console.error(`\n⚠️  The following backends are configured but not installed, messages will fail after gateway starts:`);
       for (const b of missingBackends) {
         console.error(`   ❌ ${b}`);
       }
-      console.error(`\n请先安装缺失的后端，或运行 "imtoagent setup" 修改配置。\n`);
-      // 不强制退出，允许用户先启动网关再慢慢装后端
+      console.error(`\nPlease install the missing backends, or run "imtoagent setup" to reconfigure.\n`);
+      // Don't force exit, let user start gateway and install backends later
     }
   } catch {
-    // 检查失败不影响启动
+    // Check failure doesn't block startup
   }
 
-  console.log('🚀 启动 imtoagent 网关...');
-  console.log(`   数据目录: ${dataDir}`);
-  console.log(`   配置文件: ${configPath}`);
+  console.log('🚀 Starting imtoagent gateway...');
+  console.log(`   Data directory: ${dataDir}`);
+  console.log(`   Config file: ${configPath}`);
 
-  // 使用 Bun.spawn 后台启动
+  // Launch in background using Bun.spawn
   const pkgDir = path.resolve(import.meta.dirname, '..');
   const indexFile = path.join(pkgDir, 'index.ts');
 
@@ -166,14 +166,14 @@ async function cmdStart() {
   });
 
   fs.writeFileSync(PID_FILE, String(child.pid));
-  console.log(`✅ 网关已启动 (PID=${child.pid})`);
+  console.log(`✅ Gateway started (PID=${child.pid})`);
 
-  // 后台日志重定向到 logs/
+  // Redirect background logs to logs/
   const logsDir = path.join(dataDir, 'logs');
   if (!fs.existsSync(logsDir)) fs.mkdirSync(logsDir, { recursive: true });
   const logFile = path.join(logsDir, 'imtoagent.log');
 
-  // 启动日志收集
+  // Start log collection
   (async () => {
     const logStream = fs.createWriteStream(logFile, { flags: 'a' });
     for await (const chunk of child.stdout as any) {
@@ -192,13 +192,13 @@ async function cmdStart() {
     }
   })().catch(() => {});
 
-  // 等待启动验证（5 秒内检查 PID 是否存活）
+  // Wait for startup verification (check PID survives 5s)
   await new Promise(r => setTimeout(r, 3000));
   try {
     process.kill(child.pid, 0);
-    console.log('✅ 网关运行正常');
+    console.log('✅ Gateway is running');
   } catch {
-    console.error('❌ 网关启动失败，查看日志:');
+    console.error('❌ Gateway failed to start, check logs:');
     if (fs.existsSync(logFile)) {
       console.log(fs.readFileSync(logFile, 'utf-8').slice(-2000));
     }
@@ -208,21 +208,21 @@ async function cmdStart() {
 }
 
 // ================================================================
-// stop — 停止
+// stop — stop gateway
 // ================================================================
 async function cmdStop() {
   if (!fs.existsSync(PID_FILE)) {
-    console.log('ℹ️  网关未运行');
+    console.log('ℹ️  Gateway is not running');
     return;
   }
 
   const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8').trim());
   try {
     process.kill(pid, 0);
-    console.log(`⏹  正在停止网关 (PID=${pid})...`);
+    console.log(`⏹  Stopping gateway (PID=${pid})...`);
     process.kill(pid, 'SIGTERM');
 
-    // 等待退出
+    // Wait for process to exit
     for (let i = 0; i < 20; i++) {
       try {
         process.kill(pid, 0);
@@ -232,108 +232,108 @@ async function cmdStop() {
       }
     }
 
-    // 检查是否还在
+    // Check if still running
     try {
       process.kill(pid, 0);
-      console.log('⚠️  进程未响应，强制终止...');
+      console.log('⚠️  Process not responding, force killing...');
       process.kill(pid, 'SIGKILL');
     } catch {
-      console.log('✅ 网关已停止');
+      console.log('✅ Gateway stopped');
     }
   } catch {
-    console.log('ℹ️  网关未运行（PID 文件残留，已清理）');
+    console.log('ℹ️  Gateway not running (stale PID file cleaned up)');
   }
 
   try { fs.unlinkSync(PID_FILE); } catch {}
 }
 
 // ================================================================
-// status — 状态
+// status — status check
 // ================================================================
 async function cmdStatus() {
   const dataDir = getDataDir();
 
-  console.log(`\n📊 imtoagent 状态`);
-  console.log(`   数据目录: ${dataDir}`);
+  console.log(`\n📊 imtoagent Status`);
+  console.log(`   Data directory: ${dataDir}`);
 
-  // 进程状态
+  // Process status
   if (fs.existsSync(PID_FILE)) {
     const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8').trim());
     try {
       process.kill(pid, 0);
-      console.log(`   进程: ✅ 运行中 (PID=${pid})`);
+      console.log(`   Process: ✅ Running (PID=${pid})`);
     } catch {
-      console.log(`   进程: ❌ 已停止 (PID=${pid} 不存在)`);
+      console.log(`   Process: ❌ Stopped (PID=${pid} does not exist)`);
     }
   } else {
-    console.log(`   进程: ⏸  未运行`);
+    console.log(`   Process: ⏸  Not running`);
   }
 
-  // 配置文件
+  // Config file
   const configPath = path.join(dataDir, 'config.json');
   if (fs.existsSync(configPath)) {
     try {
       const cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
       const bots = cfg.bots || [];
-      console.log(`   配置: ✅ 已配置 (${bots.length} 个 Bot)`);
+      console.log(`   Config: ✅ Configured (${bots.length} Bot(s))`);
       for (const bot of bots) {
         console.log(`     - ${bot.name} (${bot.backend})`);
       }
     } catch {
-      console.log(`   配置: ❌ 解析失败`);
+      console.log(`   Config: ❌ Parse error`);
     }
   } else {
-    console.log(`   配置: ❌ 未找到 (运行 "imtoagent setup")`);
+    console.log(`   Config: ❌ Not found (run "imtoagent setup")`);
   }
 
-  // 日志
+  // Log file
   const logFile = path.join(dataDir, 'logs', 'imtoagent.log');
   if (fs.existsSync(logFile)) {
     const stats = fs.statSync(logFile);
     const size = stats.size > 1024 * 1024
       ? (stats.size / (1024 * 1024)).toFixed(1) + ' MB'
       : (stats.size / 1024).toFixed(1) + ' KB';
-    console.log(`   日志: ${size} (${logFile})`);
+    console.log(`   Log: ${size} (${logFile})`);
   }
 
   console.log();
 }
 
 // ================================================================
-// restore — 热重载
+// restore — hot reload
 // ================================================================
 async function cmdRestore() {
   if (!fs.existsSync(PID_FILE)) {
-    console.error('❌ 网关未运行，无法热重载');
+    console.error('❌ Gateway is not running, cannot hot reload');
     process.exit(1);
   }
 
   const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8').trim());
-  console.log(`🔄 发送 SIGHUP 到网关 (PID=${pid})...`);
+  console.log(`🔄 Sending SIGHUP to gateway (PID=${pid})...`);
   try {
     process.kill(pid, 'SIGHUP');
-    console.log('✅ 热重载信号已发送');
+    console.log('✅ Hot reload signal sent');
   } catch (e: any) {
-    console.error(`❌ 发送失败: ${e.message}`);
+    console.error(`❌ Failed to send: ${e.message}`);
     process.exit(1);
   }
 }
 
 // ================================================================
-// daemon — 前台守护模式（自动重启 + 日志 + 优雅退出）
+// daemon — foreground daemon mode (auto-restart + logs + graceful shutdown)
 // ================================================================
-// 设计用途：
-//   - 前台运行，被 launchd / systemd 等进程管理器托管
-//   - 崩溃时自动重启（指数退避，最长 30s）
-//   - 收到 SIGTERM/SIGINT 时优雅关闭，不重启
-//   - 日志写入 ~/.imtoagent/logs/imtoagent.log
+// Design:
+//   - Runs in foreground, managed by launchd / systemd etc.
+//   - Auto-restarts on crash (exponential backoff, max 30s)
+//   - Graceful shutdown on SIGTERM/SIGINT, no restart
+//   - Logs written to ~/.imtoagent/logs/imtoagent.log
 // ================================================================
 async function cmdDaemon(): Promise<void> {
   const dataDir = getDataDir();
   const configPath = path.join(dataDir, 'config.json');
 
   if (!fs.existsSync(configPath)) {
-    console.error('❌ 未找到配置文件，请先运行 "imtoagent setup"');
+    console.error('❌ No config file found. Please run "imtoagent setup" first');
     process.exit(1);
   }
 
@@ -344,33 +344,33 @@ async function cmdDaemon(): Promise<void> {
   const pkgDir = path.resolve(import.meta.dirname, '..');
   const indexFile = path.join(pkgDir, 'index.ts');
 
-  console.log(`🛡  imtoagent 守护模式`);
-  console.log(`   数据目录: ${dataDir}`);
-  console.log(`   日志文件: ${logFile}`);
-  console.log(`   按 Ctrl+C 停止\n`);
+  console.log(`🛡  imtoagent Daemon Mode`);
+  console.log(`   Data directory: ${dataDir}`);
+  console.log(`   Log file: ${logFile}`);
+  console.log(`   Press Ctrl+C to stop\n`);
 
-  // 优雅退出标记
+  // Graceful shutdown flag
   let shuttingDown = false;
 
   const shutdown = () => {
     if (shuttingDown) return;
     shuttingDown = true;
-    console.log('\n🛑 收到停止信号，正在关闭...');
+    console.log('\n🛑 Received stop signal, shutting down...');
   };
 
   process.on('SIGTERM', shutdown);
   process.on('SIGINT', shutdown);
 
   let retryDelay = 0;
-  const MAX_RETRY_DELAY = 30_000; // 30s 上限
+  const MAX_RETRY_DELAY = 30_000; // 30s cap
 
   while (!shuttingDown) {
-    // 首次无延迟，之后指数退避
+    // No delay on first run, exponential backoff after
     if (retryDelay > 0) {
-      console.log(`   等待 ${retryDelay / 1000}s 后重启...`);
+      console.log(`   Waiting ${retryDelay / 1000}s before restart...`);
       await new Promise<void>(resolve => {
         const timer = setTimeout(resolve, retryDelay);
-        // 等待期间如果收到停止信号，立即退出
+        // Exit immediately if shutdown signal received during wait
         const check = setInterval(() => {
           if (shuttingDown) {
             clearTimeout(timer);
@@ -393,9 +393,9 @@ async function cmdDaemon(): Promise<void> {
 
     const childPid = child.pid;
     fs.writeFileSync(PID_FILE, String(childPid));
-    console.log(`[${new Date().toISOString()}] 🚀 启动网关 (PID=${childPid})`);
+    console.log(`[${new Date().toISOString()}] 🚀 Starting gateway (PID=${childPid})`);
 
-    // 日志收集
+    // Log collection
     const pumpStdout = (async () => {
       for await (const chunk of child.stdout as any) {
         const line = new TextDecoder().decode(chunk);
@@ -412,7 +412,7 @@ async function cmdDaemon(): Promise<void> {
       }
     })().catch(() => {});
 
-    // 等待子进程退出
+    // Wait for child process to exit
     const exitCode = await child.exited;
     await Promise.allSettled([pumpStdout, pumpStderr]);
     logStream.end();
@@ -421,17 +421,17 @@ async function cmdDaemon(): Promise<void> {
 
     if (shuttingDown) break;
 
-    // 判断是否需要重启
+    // Determine if restart needed
     if (exitCode === 0) {
-      console.log(`[${new Date().toISOString()}] ⏹  网关正常退出 (code=0)，不重启`);
+      console.log(`[${new Date().toISOString()}] ⏹  Gateway exited cleanly (code=0), not restarting`);
       break;
     }
 
-    // 崩溃 → 指数退避重启
+    // Crash → exponential backoff restart
     retryDelay = retryDelay === 0 ? 3_000 : Math.min(retryDelay * 2, MAX_RETRY_DELAY);
-    console.log(`[${new Date().toISOString()}] ⚠️  网关异常退出 (code=${exitCode})，${retryDelay / 1000}s 后重启`);
+    console.log(`[${new Date().toISOString()}] ⚠️  Gateway crashed (code=${exitCode}), restarting in ${retryDelay / 1000}s`);
   }
 
-  console.log('👋 守护进程已停止');
+  console.log('👋 Daemon stopped');
 }
 

package/bin/imtoagent.cjs

@@ -25,7 +25,7 @@ for (var i = 0; i < candidates.length; i++) {
 }
 
 if (!bunPath) {
-  console.error("❌ bun 未找到，请先安装: https://bun.sh");
+  console.error("❌ bun not found, please install: https://bun.sh");
   console.error("   curl -fsSL https://bun.sh/install | bash");
   process.exit(1);
 }