imtoagent 0.3.24 → 0.3.26

package/bin/imtoagent-real

@@ -16,7 +16,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import * as readline from 'readline';
 import { spawn, execSync } from 'child_process';
-import { getDataDir } from '../modules/utils/paths';
+import { getDataDir, getLogsDir } from '../modules/utils/paths';
 
 const PID_FILE = '/tmp/imtoagent.pid';
 
@@ -61,9 +61,21 @@ switch (command) {
   case 'health':
     await cmdHealth();
     break;
+  case 'doctor':
+    await cmdDoctor();
+    break;
+  case 'config':
+    await cmdConfig();
+    break;
   case 'autostart':
     await cmdAutostart();
     break;
+  case 'logs':
+    await cmdLogs();
+    break;
+  case 'validate':
+    await cmdValidate();
+    break;
   case undefined: {
     const dataDir = getDataDir();
     const configPath = path.join(dataDir, 'config.json');
@@ -121,9 +133,20 @@ Usage:
   imtoagent uninstall           Uninstall imtoagent (keep data by default)
   imtoagent uninstall --purge   Uninstall and delete all data
   imtoagent health              Run comprehensive health check
+  imtoagent doctor              Diagnose & fix configuration issues
+  imtoagent config              Manage Bot configuration
+  imtoagent config list         List all Bots
+  imtoagent config show NAME    Show Bot details
+  imtoagent config add          Add a new Bot
+  imtoagent config remove NAME  Remove a Bot
+  imtoagent config modify NAME  Modify Bot settings
   imtoagent autostart enable    Enable auto-start on login (launchd)
   imtoagent autostart disable   Disable auto-start
   imtoagent autostart status    Check auto-start status
+  imtoagent logs                Show last 50 lines of log
+  imtoagent logs -n N           Show last N lines
+  imtoagent logs -f             Follow log in real-time (tail -f)
+  imtoagent validate            Validate config.json for errors
 
 Data directory: ${getDataDir()}
 `);
@@ -939,6 +962,177 @@ async function cmdHealth(): Promise<void> {
   console.log();
 }
 
+// ================================================================
+// config — Bot 配置管理
+// ================================================================
+async function cmdConfig(): Promise<void> {
+  const subcommand = process.argv[3];
+
+  switch (subcommand) {
+    case 'list':
+      await cmdConfigList();
+      break;
+    case 'show': {
+      const name = process.argv[4];
+      if (!name) { console.error('Usage: imtoagent config show <name>'); process.exit(1); }
+      await cmdConfigShow(name);
+      break;
+    }
+    case 'add':
+      await cmdConfigAdd();
+      break;
+    case 'remove': {
+      const name = process.argv[4];
+      if (!name) { console.error('Usage: imtoagent config remove <name>'); process.exit(1); }
+      await cmdConfigRemove(name);
+      break;
+    }
+    case 'modify': {
+      const name = process.argv[4];
+      if (!name) { console.error('Usage: imtoagent config modify <name>'); process.exit(1); }
+      await cmdConfigModify(name);
+      break;
+    }
+    case undefined:
+    case 'help':
+    case '--help':
+    case '-h':
+      console.log(`
+imtoagent config — Manage Bot configuration
+
+Usage:
+  imtoagent config list         List all Bots
+  imtoagent config show NAME    Show Bot details
+  imtoagent config add          Add a new Bot (interactive)
+  imtoagent config remove NAME  Remove a Bot
+  imtoagent config modify NAME  Modify Bot settings
+`);
+      break;
+    default:
+      console.error(`❌ Unknown config subcommand: ${subcommand}`);
+      console.log('   Run "imtoagent config help" for usage.');
+      process.exit(1);
+  }
+}
+
+// ---- Config subcommand wrappers ----
+async function cmdConfigList(): Promise<void> {
+  const m = await import('../modules/utils/config-manager');
+  await m.cmdConfigList();
+}
+async function cmdConfigShow(name: string): Promise<void> {
+  const m = await import('../modules/utils/config-manager');
+  await m.cmdConfigShow(name);
+}
+async function cmdConfigAdd(): Promise<void> {
+  const m = await import('../modules/utils/config-manager');
+  await m.cmdConfigAdd();
+}
+async function cmdConfigRemove(name: string): Promise<void> {
+  const m = await import('../modules/utils/config-manager');
+  await m.cmdConfigRemove(name);
+}
+async function cmdConfigModify(name: string): Promise<void> {
+  const m = await import('../modules/utils/config-manager');
+  await m.cmdConfigModify(name);
+}
+
+
+// ================================================================
+// doctor — 配置诊断与自动修复
+// ================================================================
+async function cmdDoctor(): Promise<void> {
+  console.log(`\n🔧 imtoagent Doctor — Configuration Diagnosis\n`);
+
+  try {
+    const { runDoctorChecks, formatIssues } = await import('../modules/utils/doctor');
+    const issues = await runDoctorChecks();
+
+    // 分组
+    const fixableIssues = issues.filter(i => i.fixable);
+    const unfixableIssues = issues.filter(i => !i.fixable);
+    const errors = issues.filter(i => i.severity === 'error');
+    const warnings = issues.filter(i => i.severity === 'warning');
+    const infos = issues.filter(i => i.severity === 'info');
+
+    // 打印所有问题
+    if (issues.length === 0) {
+      console.log('   ✅ All checks passed! Nothing to fix.\n');
+      return;
+    }
+
+    // 打印 errors
+    if (errors.length > 0) {
+      console.log('❌ Errors:');
+      for (const e of errors) {
+        console.log(`   ${e.message}`);
+        if (e.fixable && e.fixDescription) {
+          console.log(`   → 🔧 ${e.fixDescription}`);
+        }
+      }
+      console.log();
+    }
+
+    // 打印 warnings
+    if (warnings.length > 0) {
+      console.log('⚠️  Warnings:');
+      for (const w of warnings) {
+        console.log(`   ${w.message}`);
+      }
+      console.log();
+    }
+
+    // 打印 infos
+    if (infos.length > 0) {
+      console.log('✅ OK:');
+      for (const i of infos) {
+        console.log(`   ${i.message}`);
+      }
+      console.log();
+    }
+
+    // 尝试自动修复
+    if (fixableIssues.length > 0) {
+      console.log(`─── Auto-Fix ───`);
+      let fixed = 0;
+      for (const issue of fixableIssues) {
+        if (!issue.fix) continue;
+        try {
+          console.log(`\n🔧 Fixing: ${issue.fixDescription}`);
+          const success = await issue.fix();
+          if (success) {
+            console.log(`   ✅ Fixed`);
+            fixed++;
+          } else {
+            console.log(`   ❌ Fix failed`);
+          }
+        } catch (e: any) {
+          console.log(`   ❌ Fix failed: ${e.message}`);
+        }
+      }
+      console.log(`\n   ${fixed}/${fixableIssues.length} issues fixed`);
+      if (fixed > 0) {
+        console.log(`\n💡 Run "imtoagent doctor" again to re-check after fixes.\n`);
+      }
+    }
+
+    // Summary
+    console.log('── Summary ──');
+    if (errors.length === 0) {
+      console.log('   ✅ No errors found');
+    } else {
+      console.log(`   ❌ ${errors.length} error(s) — some may be fixable`);
+    }
+    if (warnings.length > 0) {
+      console.log(`   ⚠️  ${warnings.length} warning(s) — review recommended`);
+    }
+    console.log();
+
+  } catch (e: any) {
+    console.error(`❌ Doctor check failed: ${e.message}\n`);
+    process.exit(1);
+  }
+}
 // ================================================================
 // autostart — launchd integration (macOS only)
 // ================================================================
@@ -1084,6 +1278,185 @@ async function cmdAutostartStatus(plistPath: string): Promise<void> {
   console.log();
 }
 
+// ================================================================
+// logs — 查看日志
+// ================================================================
+async function cmdLogs(): Promise<void> {
+  const argv = process.argv.slice(3);
+  let n = 50;
+  let follow = false;
+
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === '-n' && argv[i + 1]) {
+      n = parseInt(argv[++i], 10);
+      if (isNaN(n) || n < 1) {
+        console.error('❌ Invalid line count');
+        process.exit(1);
+      }
+    } else if (argv[i] === '-f') {
+      follow = true;
+    }
+  }
+
+  const logsDir = getLogsDir();
+  const logFile = path.join(logsDir, 'imtoagent.log');
+
+  if (!fs.existsSync(logFile)) {
+    console.log('ℹ️  No log file found.');
+    console.log(`   Expected: ${logFile}`);
+    console.log('   Start the gateway first: imtoagent start');
+    return;
+  }
+
+  if (follow) {
+    // tail -f mode — spawn tail process
+    console.log(`📄 Following log: ${logFile} (Ctrl+C to stop)\n`);
+    const child = spawn('tail', ['-f', '-n', String(n), logFile], {
+      stdio: 'inherit',
+    });
+
+    const cleanup = () => {
+      try { child.kill('SIGTERM'); } catch {}
+    };
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+
+    await new Promise<void>((resolve) => {
+      child.on('exit', () => resolve());
+      child.on('error', () => resolve());
+    });
+  } else {
+    // Print last N lines
+    try {
+      const content = fs.readFileSync(logFile, 'utf-8');
+      const lines = content.split('\n');
+      const tail = lines.slice(-n).filter(l => l.length > 0);
+      if (tail.length === 0) {
+        console.log('ℹ️  Log file is empty.');
+      } else {
+        console.log(`📄 Last ${tail.length} lines of ${logFile}:\n`);
+        for (const line of tail) {
+          console.log(line);
+        }
+      }
+    } catch (e: any) {
+      console.error(`❌ Failed to read log: ${e.message}`);
+      process.exit(1);
+    }
+  }
+}
+
+// ================================================================
+// validate — 验证配置文件
+// ================================================================
+async function cmdValidate(): Promise<void> {
+  const dataDir = getDataDir();
+  const configPath = path.join(dataDir, 'config.json');
+
+  console.log(`\n🔍 imtoagent Config Validation\n`);
+  console.log(`   Config: ${configPath}\n`);
+
+  const issues: string[] = [];
+  const okItems: string[] = [];
+
+  // ---- 1. Check file exists ----
+  if (!fs.existsSync(configPath)) {
+    console.error('❌ config.json not found');
+    console.error(`   Run "imtoagent setup" to create it.\n`);
+    process.exit(1);
+  }
+  okItems.push('config.json exists');
+
+  // ---- 2. Parse JSON ----
+  let raw: string;
+  let config: any;
+  try {
+    raw = fs.readFileSync(configPath, 'utf-8');
+    config = JSON.parse(raw);
+    okItems.push('JSON format is valid');
+  } catch (e: any) {
+    console.error(`❌ Invalid JSON: ${e.message}`);
+    console.error(`   Please fix the syntax error and try again.\n`);
+    process.exit(1);
+  }
+
+  // ---- 3. Validate bots array ----
+  const validIMs = ['feishu', 'telegram', 'wecom', 'wechat'];
+  const validBackends = ['claude', 'codex', 'opencode'];
+
+  if (!config.bots || !Array.isArray(config.bots)) {
+    issues.push('bots is missing or not an array');
+  } else if (config.bots.length === 0) {
+    issues.push('bots array is empty — no bots configured');
+  } else {
+    okItems.push(`bots array has ${config.bots.length} entry/entries`);
+
+    config.bots.forEach((bot: any, idx: number) => {
+      const label = `bots[${idx}]`;
+      const botName = bot.name || `(unnamed, index ${idx})`;
+
+      // Check required fields
+      if (!bot.name) issues.push(`${label}: missing required field "name"`);
+      if (!bot.im) issues.push(`${label}: missing required field "im"`);
+      if (!bot.appId) issues.push(`${label}: missing required field "appId"`);
+      if (!bot.backend) issues.push(`${label}: missing required field "backend"`);
+
+      // Validate IM platform
+      if (bot.im && !validIMs.includes(bot.im)) {
+        issues.push(`${label}: invalid im value "${bot.im}" — must be one of: ${validIMs.join(', ')}`);
+      }
+
+      // Validate backend
+      if (bot.backend && !validBackends.includes(bot.backend)) {
+        issues.push(`${label}: invalid backend value "${bot.backend}" — must be one of: ${validBackends.join(', ')}`);
+      }
+    });
+  }
+
+  // ---- 4. Validate workspace config ----
+  const ws = config.workspace || {};
+  if (ws.mode === 'global') {
+    if (!ws.globalPath) {
+      issues.push('workspace: mode is "global" but globalPath is not set');
+    } else {
+      if (!fs.existsSync(ws.globalPath)) {
+        issues.push(`workspace: globalPath directory does not exist: ${ws.globalPath}`);
+      } else {
+        okItems.push(`workspace: globalPath exists (${ws.globalPath})`);
+      }
+    }
+  } else if (ws.mode && ws.mode !== 'sandbox') {
+    issues.push(`workspace: invalid mode "${ws.mode}" — must be "sandbox" or "global"`);
+  } else {
+    okItems.push(`workspace: mode is "${ws.mode || 'sandbox'}" (default)`);
+  }
+
+  // ---- Print results ----
+  if (okItems.length > 0) {
+    console.log('✅ OK:');
+    for (const item of okItems) {
+      console.log(`   ✓ ${item}`);
+    }
+    console.log();
+  }
+
+  if (issues.length > 0) {
+    console.log('❌ Issues:');
+    for (const issue of issues) {
+      console.log(`   ✗ ${issue}`);
+    }
+    console.log();
+  }
+
+  // Summary
+  if (issues.length === 0) {
+    console.log('✅ Configuration is valid!\n');
+  } else {
+    console.log(`❌ ${issues.length} issue(s) found. Please fix them.\n`);
+    process.exit(1);
+  }
+}
+
 // ================================================================
 // version-check — non-blocking npm registry check
 // ================================================================

package/index.ts

@@ -289,6 +289,7 @@ interface BotConfig {
   appSecret: string;
   backend: 'claude' | 'codex' | 'opencode';
   cwd?: string;
+  isAdmin?: boolean;  // true = 可以修改网关配置，默认第一个 Bot 为 true
 }
 
 // ================================================================
@@ -307,6 +308,7 @@ class Bot {
   soul: string;
   client: Lark.Client;
   im: IMModule;
+  isAdmin: boolean;
   config: any;
   workspaceManager: WorkspaceManager;
 
@@ -327,6 +329,7 @@ class Bot {
     this.appSecret = cfg.appSecret;
     this.defaultCwd = cfg.cwd || globalConfig.system?.defaultProjectDir || path.join(os.homedir(), 'Projects');
     this.config = globalConfig;
+    this.isAdmin = cfg.isAdmin !== undefined ? cfg.isAdmin : true; // 默认 true（后向兼容老用户）
     this.workspaceManager = workspaceManager;
 
     // 确保工作空间目录存在
@@ -412,8 +415,13 @@ class Bot {
       if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
       const hasFiles = fs.readdirSync(dir).some((f: string) => f.endsWith('.md'));
       if (hasFiles) return;
+      // 根据 isAdmin 生成不同的 rules.md
+      const rulesMd = this.isAdmin
+        ? '# Bot Rules\n\nYou are an **admin Bot** with full gateway management privileges.\n\n- You can modify IMtoAgent configuration (config.json, providers, Bot management)\n- You have access to any directory (global workspace mode)\n- Sensitive information such as project keys, tokens, and passwords must not be leaked\n- Destructive commands must not be executed without explicit confirmation'
+        : '# Bot Rules\n\nYou are a **non-admin Bot** with restricted privileges.\n\n- ⛔ NEVER modify any files under ~/.imtoagent/ (config.json, providers.json, etc.)\n- ⛔ NEVER read or expose gateway configuration contents\n- ⛔ NEVER attempt to add, remove, or modify Bot configurations\n- Your working directory is limited to your assigned workspace\n- All file operations must stay within your workspace boundary\n- Sensitive information such as project keys, tokens, and passwords must not be leaked\n- Destructive commands must not be executed without explicit confirmation';
+
       const defaults: Record<string, string> = {
-        'rules.md': '# Hard Constraint Rules\n\nThe following rules cannot be overridden or modified:\n\n- Sensitive information such as project keys, tokens, and passwords must not be leaked\n- Destructive commands must not be executed',
+        'rules.md': rulesMd,
         'identity.md': `# Identity\n\n- I am an AI programming assistant connected via IMtoAgent\n- I run on the ${this.backend === 'codex' ? 'Codex' : 'Claude Code'} backend\n- Reply in Chinese`,
         'profile.md': '# User Profile\n\nThis file can be modified by the Agent. When the user says "remember xxx" or "I prefer xxx", the Agent should update this file.\n\n## Modification Guide (Agent Only)\n\nRead this file → Add/delete/modify entries based on user requests → Save',
         'workspace.md': '# Project Environment\n\nAuto-generated by IMtoAgent.',
@@ -437,11 +445,30 @@ class Bot {
       for (const file of order) {
         const fp = dir + '/' + file;
         if (fs.existsSync(fp)) {
-          const content = fs.readFileSync(fp, 'utf-8').trim();
-          if (content) parts.push(content);
+          const c = fs.readFileSync(fp, 'utf-8').trim();
+          if (c) parts.push(c);
         }
       }
     } catch {}
+
+    // Inject config CLI reference — so the Agent knows how to manage Bots via natural language
+    const adminTag = this.isAdmin ? '' : ' (you are a non-admin Bot — you cannot use these commands, tell the user to use an admin Bot)';
+    const bt = String.fromCharCode(96);  // backtick
+    const fence = bt + bt + bt;
+    const cliRef = '## IMtoAgent Config CLI' +
+      '\n\nYou can manage Bot configurations via these CLI commands:' + adminTag +
+      '\n\n' + fence + 'bash' +
+      '\nimtoagent config list              # List all Bots' +
+      '\nimtoagent config show <BotName>    # Show a Bot\'s details' +
+      '\nimtoagent config add               # Add a new Bot (interactive)' +
+      '\nimtoagent config remove <BotName>  # Remove a Bot' +
+      '\nimtoagent config modify <BotName>  # Modify a Bot\'s settings' +
+      '\nimtoagent restore                  # Hot-reload after config changes' +
+      '\nimtoagent doctor                   # Diagnose config issues' +
+      '\n' + fence +
+      '\n\nWhen the user asks to manage Bots, use these commands. After changes, run ' + bt + 'imtoagent restore' + bt + '.';
+    parts.push(cliRef);
+
     return parts.join('\n\n');
   }
 
@@ -499,7 +526,7 @@ class Bot {
         : `⏸ ${this.backend} idle | ${this.activeModel}`);
 
     cmd('/info', ({ session }) =>
-      `🤖 ${this.name} (${this.backend})\nModel: ${this.activeModel}\nDirectory: ${session?.cwd || this.defaultCwd}\nSessions: ${this.sessions.size}`);
+      `🤖 ${this.name} (${this.backend})${this.isAdmin ? ' ⭐' : ''}\nModel: ${this.activeModel}\nDirectory: ${session?.cwd || this.defaultCwd}\nSessions: ${this.sessions.size}`);
 
     cmd('/stats', ({ session }) => {
       if (!session || session.stats.calls === 0) return '📊 No calls yet';

package/modules/cli/setup.ts

@@ -461,6 +461,7 @@ export async function runSetupWizard(options?: SetupOptions): Promise<void> {
       name: botName,
       backend,
       cwd: cwd || os.homedir(),
+      isAdmin: bots.length === 0,  // 第一个 Bot 为 admin，后续为 false
     };
 
     // Feishu needs appId + appSecret

package/modules/core/types.ts

@@ -242,6 +242,7 @@ export interface BotConfig {
   /** 唯一标识（UUID，用于目录/文件隔离，改名不影响） */
   id?: string;
   name: string;
+  im: string; // 'feishu' | 'telegram' | 'wecom' | 'wechat'
   backend: string; // 'claude' | 'codex' | 'opencode'
   appId: string;
   appSecret: string;