@keyou007/agent-bot 0.1.3 → 0.1.4

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@keyou007/agent-bot",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@keyou007/agent-bot",
-      "version": "0.1.3",
+      "version": "0.1.4",
       "license": "GPL-3.0-only",
       "dependencies": {
         "@agentclientprotocol/sdk": "1.2.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keyou007/agent-bot",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "description": "Using Codex in Lark/Feishu feels just like using native Codex.",
   "license": "GPL-3.0-only",

package/skills/agent-bot/SKILL.md

@@ -74,7 +74,7 @@ agent-bot server status
 agent-bot task list
 ```
 
-`agent-bot --help` uses Chinese when the system locale is Chinese and English otherwise.
+All Agent Bot CLI interface text is English regardless of system locale. `agent-bot server status` also reports the running profile's Lark App ID; with `--json`, read it from `feishuAppId`.
 
 Add `--json` to status and list commands when machine-readable output helps. If `agent-bot` is unavailable, report that the CLI is not installed or linked instead of guessing process state.
 

package/src/cli/FeishuAppConfiguration.ts

@@ -178,8 +178,8 @@ export async function ensureFeishuAppConfiguration(
     }
   }
 
-  const detail = lastError instanceof Error ? ` 最后一次检查失败：${lastError.message}` : "";
-  throw new Error(`等待飞书核心权限和消息事件配置生效超时，请重新运行 agent-bot init。${detail}`);
+  const detail = lastError instanceof Error ? ` Last check failed: ${lastError.message}` : "";
+  throw new Error(`Timed out waiting for the core Lark scopes and message event. Run agent-bot init again.${detail}`);
 }
 
 async function requestMissingFeishuConfiguration(
@@ -248,14 +248,14 @@ async function readFeishuAppConfiguration(
       `${FEISHU_OPEN_BASE_URL}${APPLICATION_PATH_PREFIX}/${appId}?lang=zh_cn`,
       { headers },
       signal,
-      "查询飞书应用配置",
+      "Read Lark app configuration",
     ),
     fetchJson(
       fetchImpl,
       `${FEISHU_OPEN_BASE_URL}${APPLICATION_PATH_PREFIX}/${appId}/app_versions?lang=zh_cn&page_size=2`,
       { headers },
       signal,
-      "查询飞书应用版本",
+      "Read Lark app versions",
     ),
   ]);
 
@@ -303,10 +303,10 @@ async function getTenantAccessToken(
       }),
     },
     signal,
-    "获取飞书 tenant_access_token",
+    "Get the Lark tenant_access_token",
   );
   const token = readString(payload, "tenant_access_token");
-  if (!token) throw new Error("飞书 tenant_access_token 响应缺少访问凭证。");
+  if (!token) throw new Error("The Lark tenant_access_token response is missing the access token.");
   return token;
 }
 
@@ -327,12 +327,12 @@ async function fetchJson(
     const response = await fetchImpl(url, { ...init, signal: controller.signal });
     const payload = (await response.json().catch(() => undefined)) as unknown;
     if (!isJsonObject(payload)) {
-      throw new Error(`${operation}返回了无法解析的响应（HTTP ${response.status}）。`);
+      throw new Error(`${operation} returned an invalid response (HTTP ${response.status}).`);
     }
     const code = readNumber(payload, "code");
     if (!response.ok || code !== 0) {
       throw new FeishuConfigurationApiError(
-        `${operation}失败：${readString(payload, "msg") || response.statusText || `HTTP ${response.status}`}`,
+        `${operation} failed: ${readString(payload, "msg") || response.statusText || `HTTP ${response.status}`}`,
         code,
         response.status,
       );
@@ -340,7 +340,7 @@ async function fetchJson(
     return payload;
   } catch (error) {
     if (parentSignal?.aborted) throw abortError(parentSignal);
-    if (controller.signal.aborted) throw new Error(`${operation}请求超时。`);
+    if (controller.signal.aborted) throw new Error(`${operation} timed out.`);
     throw error;
   } finally {
     clearTimeout(timeout);
@@ -442,7 +442,7 @@ function positiveInteger(value: number | undefined): number | undefined {
 }
 
 function abortError(signal: AbortSignal): Error {
-  return signal.reason instanceof Error ? signal.reason : new Error("飞书应用配置已取消。");
+  return signal.reason instanceof Error ? signal.reason : new Error("Lark app configuration was cancelled.");
 }
 
 function delay(milliseconds: number): Promise<void> {

package/src/cli/FeishuAppRegistration.ts

@@ -41,12 +41,12 @@ export async function registerFeishuApp(options: FeishuAppRegistrationOptions =
     },
     options.signal,
   );
-  throwRegistrationError(begin, "无法发起飞书应用创建");
+  throwRegistrationError(begin, "Could not start Lark app creation");
 
   const deviceCode = readString(begin, "device_code");
   const userCode = readString(begin, "user_code");
   if (!deviceCode || !userCode) {
-    throw new Error("飞书应用创建响应缺少 device_code 或 user_code。");
+    throw new Error("The Lark app creation response is missing device_code or user_code.");
   }
 
   const expiresIn =
@@ -113,16 +113,16 @@ export async function registerFeishuApp(options: FeishuAppRegistrationOptions =
         intervalSeconds = Math.min(intervalSeconds + 5, MAX_POLL_INTERVAL_SECONDS);
         continue;
       case "access_denied":
-        throw new Error("你已取消飞书应用创建。");
+        throw new Error("Lark app creation was cancelled.");
       case "expired_token":
       case "invalid_grant":
-        throw new Error("飞书应用创建链接已过期，请重新运行 agent-bot init。");
+        throw new Error("The Lark app creation link expired. Run agent-bot init again.");
       default:
-        throwRegistrationError(payload, "飞书应用创建失败");
+        throwRegistrationError(payload, "Lark app creation failed");
     }
   }
 
-  throw new Error("等待飞书应用创建超时，请重新运行 agent-bot init。");
+  throw new Error("Timed out waiting for Lark app creation. Run agent-bot init again.");
 }
 
 function buildVerificationUrl(userCode: string): string {
@@ -152,7 +152,7 @@ async function postRegistration(
     });
     const payload = (await response.json().catch(() => undefined)) as unknown;
     if (!isRecord(payload)) {
-      throw new Error(`飞书应用注册接口返回了无法解析的响应（HTTP ${response.status}）。`);
+      throw new Error(`The Lark app registration endpoint returned an invalid response (HTTP ${response.status}).`);
     }
     return payload;
   } finally {
@@ -165,7 +165,7 @@ function throwRegistrationError(payload: RegistrationPayload, prefix: string): v
   const code = readString(payload, "error");
   if (!code) return;
   const description = readString(payload, "error_description") || code;
-  throw new Error(`${prefix}：${description}`);
+  throw new Error(`${prefix}: ${description}`);
 }
 
 function readString(value: RegistrationPayload, key: string): string {
@@ -189,7 +189,7 @@ function isRecord(value: unknown): value is RegistrationPayload {
 }
 
 function abortError(signal: AbortSignal): Error {
-  return signal.reason instanceof Error ? signal.reason : new Error("飞书应用创建已取消。");
+  return signal.reason instanceof Error ? signal.reason : new Error("Lark app creation was cancelled.");
 }
 
 function delay(milliseconds: number): Promise<void> {

package/src/cli/Initializer.ts

@@ -122,7 +122,7 @@ export function writeFeishuCredentials(envPath: string, credentials: FeishuCrede
       || persisted.appSecret !== credentials.appSecret
       || persisted.userOpenId !== credentials.userOpenId
     ) {
-      throw new Error("飞书凭据写入后校验失败。");
+      throw new Error("Lark credential verification failed after writing the environment file.");
     }
   } finally {
     if (temporaryFile !== undefined) fs.closeSync(temporaryFile);
@@ -169,13 +169,13 @@ export function acquireInitializationLock(lockDirectory: string): Initialization
       if (created) fs.rmSync(lockPath, { force: true });
       if (!isFileExistsError(error)) throw error;
       if (!isStaleInitializationLock(lockPath)) {
-        throw new Error(`另一个 agent-bot init 正在运行（锁文件：${lockPath}）。`);
+        throw new Error(`Another agent-bot init process is running (lock file: ${lockPath}).`);
       }
       fs.rmSync(lockPath, { force: true });
     }
   }
 
-  throw new Error(`无法获取初始化锁：${lockPath}`);
+  throw new Error(`Could not acquire the initialization lock: ${lockPath}`);
 }
 
 export function cleanupFeishuCredentialTemporaryFiles(envPath: string): number {
@@ -234,7 +234,7 @@ function upsertDotEnvValue(contents: string, key: string, value: string): string
 
 function assertDotEnvValue(key: string, value: string): void {
   if (!value.trim() || /[\r\n]/.test(value)) {
-    throw new Error(`${key} 不是有效的单行环境变量值。`);
+    throw new Error(`${key} is not a valid single-line environment variable value.`);
   }
 }
 

package/src/cli/LocalControlClient.ts

@@ -17,7 +17,7 @@ export async function sendControlRequest(
       socket.destroy();
       operation();
     };
-    const timer = setTimeout(() => finish(() => reject(new Error("连接 Agent Bot 控制端点超时。"))), timeoutMs);
+    const timer = setTimeout(() => finish(() => reject(new Error("Timed out connecting to the Agent Bot control endpoint."))), timeoutMs);
     socket.setEncoding("utf8");
     socket.once("connect", () => socket.write(`${JSON.stringify(request)}\n`));
     socket.on("data", (chunk: string) => {
@@ -33,7 +33,7 @@ export async function sendControlRequest(
     });
     socket.once("error", (error) => finish(() => reject(error)));
     socket.once("end", () => {
-      if (!settled) finish(() => reject(new Error("Agent Bot 控制端点未返回结果。")));
+      if (!settled) finish(() => reject(new Error("The Agent Bot control endpoint returned no response.")));
     });
   });
 }

package/src/cli/LocalControlServer.ts

@@ -61,7 +61,7 @@ export class LocalControlServer {
 function parseRequest(line: string): ControlRequest {
   const value = JSON.parse(line) as unknown;
   if (!value || typeof value !== "object" || !("action" in value) || typeof value.action !== "string") {
-    throw new Error("无效的本地控制请求。");
+    throw new Error("Invalid local control request.");
   }
   return value as ControlRequest;
 }

package/src/cli/ServerStarter.ts

@@ -56,7 +56,7 @@ export async function startServer(
   if (await dependencies.isReachable(endpoint)) {
     const running = await dependencies.waitUntilRunning(endpoint, SERVER_START_TIMEOUT_MS);
     if (!running) {
-      throw new Error("agent-bot server 已启动，但未能连接飞书机器人。请检查日志。");
+      throw new Error("The Agent Bot server started but could not connect to Lark. Check the logs.");
     }
     return { status: "started" };
   }
@@ -64,7 +64,7 @@ export async function startServer(
   dependencies.spawnSupervisor(config);
   const running = await dependencies.waitUntilRunning(endpoint, SERVER_START_TIMEOUT_MS);
   if (!running) {
-    throw new Error("已启动 Supervisor，但 server 未在 45 秒内连接飞书机器人。请检查日志。");
+    throw new Error("The Supervisor started, but the server did not connect to Lark within 45 seconds. Check the logs.");
   }
   return { status: "started" };
 }
@@ -85,7 +85,7 @@ const defaultDependencies: ServerStarterDependencies = {
       detached: true,
       windowsHide: true,
       stdio: "ignore",
-      env: { ...process.env, AGENT_BOT_RESTART_REASON: "通过 agent-bot CLI 启动" },
+      env: { ...process.env, AGENT_BOT_RESTART_REASON: "通过 Agent Bot CLI 启动" },
     });
     child.unref();
   },

package/src/cli/SkillRegistry.ts

@@ -65,7 +65,7 @@ export class SkillRegistry {
     this.assertValidSource();
     const existing = fs.existsSync(this.targetPath);
     if (existing && this.readMarker()?.managedBy !== "agent-bot") {
-      throw new Error(`目标目录已存在且不由 Agent Bot 管理：${this.targetPath}`);
+      throw new Error(`The target directory exists and is not managed by Agent Bot: ${this.targetPath}`);
     }
 
     const before = existing ? this.status() : undefined;
@@ -93,7 +93,7 @@ export class SkillRegistry {
   uninstall(): boolean {
     if (!fs.existsSync(this.targetPath)) return false;
     if (this.readMarker()?.managedBy !== "agent-bot") {
-      throw new Error(`拒绝删除不由 Agent Bot 管理的目录：${this.targetPath}`);
+      throw new Error(`Refusing to remove a directory that is not managed by Agent Bot: ${this.targetPath}`);
     }
     this.removeManagedTarget();
     return true;
@@ -101,13 +101,13 @@ export class SkillRegistry {
 
   private assertValidSource(): void {
     if (!fs.existsSync(path.join(this.sourcePath, "SKILL.md"))) {
-      throw new Error(`找不到内置 Agent Bot Skill：${this.sourcePath}`);
+      throw new Error(`The built-in Agent Bot Skill was not found: ${this.sourcePath}`);
     }
   }
 
   private assertSafeTarget(): void {
     if (path.dirname(this.targetPath) !== this.skillsRoot || path.basename(this.targetPath) !== SKILL_NAME) {
-      throw new Error(`不安全的 Skill 目标路径：${this.targetPath}`);
+      throw new Error(`Unsafe Skill target path: ${this.targetPath}`);
     }
   }
 

package/src/cli/help.ts

@@ -1,63 +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
-
-选项：
-  --profile <directory>             使用指定目录中的独立 Profile
-  --config <path>                   使用指定配置文件
-  --json                            在支持的命令中输出 JSON
-  -h, --help                        显示帮助
-  -v, --version                     显示版本
-
-示例：
-  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 "升级 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.
 
@@ -68,7 +9,7 @@ Common commands:
   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
@@ -96,8 +37,3 @@ Examples:
   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

@@ -22,7 +22,7 @@ export function parseGlobalOptions(input: string[]): ParsedGlobalOptions {
   const configPath = removeOption(args, "--config");
   const profilePath = removeOption(args, "--profile");
   if (configPath && profilePath) {
-    throw new Error("--profile 和 --config 不能同时使用。Profile 固定使用其目录下的 config.yaml。");
+    throw new Error("--profile and --config cannot be used together. A profile always uses config.yaml in its directory.");
   }
   return {
     args,
@@ -49,11 +49,11 @@ export function applyExplicitProfile(
 
 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} 只能指定一次。`);
+  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} 需要目录或文件路径。`);
+  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;