@keyou007/agent-bot 0.1.2 → 0.1.4

package/src/cli/help.ts

@@ -1,61 +1,4 @@
-export type CliLanguage = "en" | "zh";
-
-export function resolveCliLanguage(
-  env: NodeJS.ProcessEnv = process.env,
-  systemLocale = Intl.DateTimeFormat().resolvedOptions().locale,
-): CliLanguage {
-  const configuredLocale = [
-    env.LC_ALL,
-    env.LC_MESSAGES,
-    env.LANGUAGE,
-    env.LANG,
-  ].find((value) => value?.trim());
-  return isChineseLocale(configuredLocale ?? systemLocale) ? "zh" : "en";
-}
-
-export function renderCliHelp(version: string, language = resolveCliLanguage()): string {
-  return language === "zh" ? renderChineseHelp(version) : renderEnglishHelp(version);
-}
-
-function renderChineseHelp(version: string): string {
-  return `Agent Bot ${version}
-通过飞书/Lark 使用本机 Codex 与 ACP Agent。
-
-用法：
-  agent-bot [选项] <命令>
-
-常用命令：
-  init                              初始化配置、数据目录和飞书应用
-  console                           打开本地 Console
-  server start                      在后台启动 Agent Bot
-  server status                     查看服务和安全重启状态
-  server restart                    安排安全重启
-  server stop                       停止 Agent Bot
-  task list                         列出任务
-  task status <task>                查看任务状态
-  task chat <task>                  查看任务绑定的飞书会话
-  task prompt <task> <prompt>       向指定任务发送 Prompt
-  task stop <task>                  停止指定任务
-  task title <task> <title>         修改任务标题
-  skills status                     查看内置 Skill 状态
-  skills install                    安装内置 Skill
-
-选项：
-  --config <path>                   使用指定配置文件
-  --json                            在支持的命令中输出 JSON
-  -h, --help                        显示帮助
-  -v, --version                     显示版本
-
-示例：
-  agent-bot init
-  agent-bot server start
-  agent-bot server status
-  agent-bot task list
-  agent-bot server restart --reason "升级 Agent Bot"
-`;
-}
-
-function renderEnglishHelp(version: string): string {
+export function renderCliHelp(version: string): string {
   return `Agent Bot ${version}
 Use local Codex and ACP agents from Lark/Feishu.
 
@@ -63,10 +6,10 @@ Usage:
   agent-bot [options] <command>
 
 Common commands:
-  init                              Initialize config, data directories, and the Lark app
+  init                              Initialize the Lark app and start the service
   console                           Open the local console
   server start                      Start Agent Bot in the background
-  server status                     Show server and safe-restart status
+  server status                     Show the server, Lark App ID, and safe-restart status
   server restart                    Schedule a safe restart
   server stop                       Stop Agent Bot
   task list                         List tasks
@@ -79,6 +22,7 @@ Common commands:
   skills install                    Install the built-in Skill
 
 Options:
+  --profile <directory>             Use an isolated profile directory
   --config <path>                   Use a specific config file
   --json                            Print JSON when supported
   -h, --help                        Show help
@@ -86,14 +30,10 @@ Options:
 
 Examples:
   agent-bot init
+  agent-bot --profile ~/.agent-bot-rescue init
   agent-bot server start
   agent-bot server status
   agent-bot task list
   agent-bot server restart --reason "Update Agent Bot"
 `;
 }
-
-function isChineseLocale(value: string): boolean {
-  const locale = value.trim().split(":")[0]?.split(/[.@]/)[0]?.replaceAll("_", "-").toLowerCase();
-  return locale === "zh" || Boolean(locale?.startsWith("zh-"));
-}

package/src/cli/packageVersion.ts

@@ -8,7 +8,7 @@ export function readPackageVersion(
     fs.readFileSync(fileURLToPath(packageJsonUrl), "utf8"),
   ) as { version?: unknown };
   if (typeof metadata.version !== "string" || !metadata.version.trim()) {
-    throw new Error("package.json 中缺少有效的 version。");
+    throw new Error("package.json does not contain a valid version.");
   }
   return metadata.version;
 }

package/src/cli/profile.ts

@@ -0,0 +1,59 @@
+import path from "node:path";
+import {
+  AGENT_BOT_EXPLICIT_PROFILE_ENV,
+  AGENT_BOT_HOME_ENV,
+  DEFAULT_CONFIG_FILE,
+  resolveUserPath,
+} from "../config/paths.js";
+
+export interface ParsedGlobalOptions {
+  args: string[];
+  configPath?: string;
+  profilePath?: string;
+}
+
+export interface AppliedProfile {
+  homePath: string;
+  configPath: string;
+}
+
+export function parseGlobalOptions(input: string[]): ParsedGlobalOptions {
+  const args = [...input];
+  const configPath = removeOption(args, "--config");
+  const profilePath = removeOption(args, "--profile");
+  if (configPath && profilePath) {
+    throw new Error("--profile and --config cannot be used together. A profile always uses config.yaml in its directory.");
+  }
+  return {
+    args,
+    ...(configPath ? { configPath } : {}),
+    ...(profilePath ? { profilePath } : {}),
+  };
+}
+
+export function applyExplicitProfile(
+  profilePath: string,
+  env: NodeJS.ProcessEnv = process.env,
+  baseDirectory = process.cwd(),
+): AppliedProfile {
+  const homePath = resolveUserPath(profilePath, baseDirectory);
+  const configPath = path.join(homePath, DEFAULT_CONFIG_FILE);
+  env[AGENT_BOT_HOME_ENV] = homePath;
+  env.AGENT_BOT_CONFIG = configPath;
+  env[AGENT_BOT_EXPLICIT_PROFILE_ENV] = "1";
+  delete env.FEISHU_APP_ID;
+  delete env.FEISHU_APP_SECRET;
+  delete env.FEISHU_USER_OPEN_ID;
+  return { homePath, configPath };
+}
+
+function removeOption(args: string[], option: string): string | undefined {
+  const indexes = args.flatMap((value, index) => value === option ? [index] : []);
+  if (indexes.length > 1) throw new Error(`${option} can only be specified once.`);
+  const index = indexes[0];
+  if (index === undefined) return undefined;
+  const value = args[index + 1];
+  if (!value || value.startsWith("--")) throw new Error(`${option} requires a directory or file path.`);
+  args.splice(index, 2);
+  return value;
+}

package/src/cli/serverStatus.ts

@@ -0,0 +1,39 @@
+export function withConfiguredFeishuAppId(
+  data: unknown,
+  configuredFeishuAppId?: string,
+): Record<string, unknown> {
+  const value = data && typeof data === "object"
+    ? data as Record<string, unknown>
+    : {};
+  if (Object.hasOwn(value, "feishuAppId")) return value;
+  return {
+    ...value,
+    feishuAppId: configuredFeishuAppId ?? null,
+  };
+}
+
+export function formatServerStatus(data: unknown): string {
+  const value = data && typeof data === "object" ? data as Record<string, unknown> : {};
+  const activity = value.activity && typeof value.activity === "object"
+    ? value.activity as Record<string, unknown>
+    : {};
+  const state = value.running === false
+    ? "not running"
+    : value.ready === false
+      ? "starting (connecting to Lark)"
+      : "running";
+  const safeRestart = value.safeRestartScheduled
+    ? `pending (${String(value.safeRestartReason ?? "no reason provided")})`
+    : "not scheduled";
+  return [
+    `Agent Bot server: ${state}`,
+    `Lark App ID: ${value.feishuAppId ?? "not configured"}`,
+    `PID: ${value.pid ?? "-"}`,
+    `Started at: ${value.startedAt ?? "-"}`,
+    `Supervisor: ${value.supervised ? "enabled" : "disabled"}`,
+    `Running tasks: ${activity.runningSessions ?? 0}`,
+    `Pending final deliveries: ${activity.pendingFinalDeliveries ?? 0}`,
+    `Safe restart: ${safeRestart}`,
+    "",
+  ].join("\n");
+}

package/src/cli/taskChatRoute.ts

@@ -15,10 +15,10 @@ export function taskChatRoute(session: SessionRecord): TaskChatRoute {
   const contextKey = session.contextKey;
   const baseContextKey = baseChatContextKey(contextKey);
   if (!baseContextKey.startsWith(CHAT_CONTEXT_PREFIX)) {
-    throw new Error(`任务没有绑定飞书会话：${session.remoteSessionId ?? session.acpSessionId ?? session.localSessionId}`);
+    throw new Error(`The task is not bound to a Lark chat: ${session.remoteSessionId ?? session.acpSessionId ?? session.localSessionId}`);
   }
   const chatId = baseContextKey.slice(CHAT_CONTEXT_PREFIX.length);
-  if (!chatId) throw new Error(`任务的飞书会话 ID 无效：${contextKey}`);
+  if (!chatId) throw new Error(`The task has an invalid Lark chat ID: ${contextKey}`);
   const threadId = isThreadContextKey(contextKey)
     ? contextKey.slice(contextKey.indexOf(THREAD_CONTEXT_MARKER) + THREAD_CONTEXT_MARKER.length)
     : undefined;