@keyou007/agent-bot 0.1.14-alpha.0 → 0.1.14-alpha.2

package/src/cli/autostartOutput.ts

@@ -0,0 +1,75 @@
+import type { AutostartRegistrationStatus } from "./AutostartManager.js";
+import { cliLanguage, cliText, type CliLanguage } from "./i18n.js";
+
+export interface AutostartServerStatus {
+  running: boolean;
+  ready: boolean;
+}
+
+export interface CombinedAutostartStatus {
+  registration: AutostartRegistrationStatus;
+  server: AutostartServerStatus;
+}
+
+export function formatAutostartStatus(
+  status: CombinedAutostartStatus,
+  language: CliLanguage = cliLanguage,
+): string {
+  const registration = status.registration;
+  const enabled = registration.supported
+    ? registration.enabled
+      ? cliText("enabled", "已启用", language)
+      : cliText("disabled", "未启用", language)
+    : cliText("unsupported", "不支持", language);
+  const server = !status.server.running
+    ? cliText("not running", "未运行", language)
+    : status.server.ready
+      ? cliText("running", "运行中", language)
+      : cliText("starting", "启动中", language);
+  const lines = [
+    `${cliText("Agent Bot autostart: ", "Agent Bot 自启动：", language)}${enabled}`,
+    `${cliText("Platform: ", "平台：", language)}${platformLabel(registration.platform, language)}`,
+    `${cliText("Profile: ", "Profile：", language)}${registration.profilePath}`,
+    `${cliText("Config: ", "配置：", language)}${registration.configPath}`,
+  ];
+  if (registration.name) {
+    lines.push(`${cliText("Registration: ", "启动项：", language)}${registration.name}`);
+  }
+  if (registration.definitionPath) {
+    lines.push(`${cliText("Definition: ", "定义文件：", language)}${registration.definitionPath}`);
+  }
+  if (registration.mechanism) {
+    const mechanism = registration.mechanism === "task-scheduler"
+      ? "Task Scheduler"
+      : registration.mechanism === "startup-folder"
+        ? cliText("Startup folder", "启动文件夹", language)
+        : registration.mechanism === "launch-agent"
+          ? "LaunchAgent"
+          : "systemd";
+    lines.push(`${cliText("Mechanism: ", "启动机制：", language)}${mechanism}`);
+  }
+  if (registration.trigger) {
+    lines.push(`${cliText("Trigger: ", "触发方式：", language)}${registration.trigger === "boot"
+      ? cliText("system boot (systemd linger enabled)", "系统启动（已启用 systemd linger）", language)
+      : cliText("user login", "用户登录", language)}`);
+  }
+  if (registration.loaded !== undefined) {
+    lines.push(`${cliText("Loaded by OS: ", "操作系统已加载：", language)}${registration.loaded
+      ? cliText("yes", "是", language)
+      : cliText("no", "否", language)}`);
+  }
+  if (registration.platform === "linux") {
+    lines.push(`${cliText("Systemd linger: ", "Systemd linger：", language)}${registration.linger
+      ? cliText("enabled", "已启用", language)
+      : cliText("disabled", "未启用", language)}`);
+  }
+  lines.push(`${cliText("Agent Bot server: ", "Agent Bot 服务：", language)}${server}`, "");
+  return lines.join("\n");
+}
+
+function platformLabel(platform: NodeJS.Platform, language: CliLanguage): string {
+  if (platform === "win32") return "Windows";
+  if (platform === "darwin") return "macOS";
+  if (platform === "linux") return "Linux";
+  return cliText(`${platform} (unsupported)`, `${platform}（不支持）`, language);
+}

package/src/cli/controlProtocol.ts

@@ -1,8 +1,16 @@
 import { createHash } from "node:crypto";
 import path from "node:path";
 import type { TurnViewState } from "../presentation/turnViewTypes.js";
-import type { RemoteSessionSummary } from "../runtime/types.js";
+import type {
+  ModelOption,
+  ModelProviderOption,
+  PermissionMode,
+  ReasoningEffortOption,
+  RemoteSessionSummary,
+  RuntimeGoal,
+} from "../runtime/types.js";
 import type { SessionRecord } from "../state/StateStore.js";
+import type { ShellCommandResult } from "../utils/executeShellCommand.js";
 
 export type ControlRequest =
   | { action: "health" }
@@ -12,11 +20,53 @@ export type ControlRequest =
       reason: string;
       notificationSessionId?: string;
     }
+  | {
+      action: "server_update";
+      planPath: string;
+      reason: string;
+      notificationSessionId?: string;
+    }
   | { action: "server_stop" }
   | { action: "task_status"; localSessionId: string }
   | { action: "task_stop"; localSessionId: string }
+  | { action: "task_archive"; localSessionId: string }
   | { action: "task_title"; localSessionId: string; title: string }
   | { action: "task_prompt"; localSessionId: string; text: string }
+  | {
+      action: "task_new";
+      localSessionId: string;
+      title?: string;
+      cwd?: string;
+      agentName?: string;
+      projectless?: boolean;
+    }
+  | { action: "task_fork"; localSessionId: string }
+  | {
+      action: "task_switch";
+      localSessionId: string;
+      targetLocalSessionId?: string;
+      previous?: boolean;
+    }
+  | { action: "task_queue"; localSessionId: string; text: string }
+  | { action: "task_agent"; localSessionId: string; agentName?: string }
+  | {
+      action: "task_settings";
+      localSessionId: string;
+      setting?: "provider" | "model" | "thinking" | "permissions";
+      value?: string;
+    }
+  | {
+      action: "task_goal";
+      localSessionId: string;
+      goalAction: "show" | "set" | "edit" | "pause" | "resume" | "clear";
+      objective?: string;
+    }
+  | { action: "task_turns"; localSessionId: string }
+  | { action: "task_reset"; localSessionId: string; turnId: string }
+  | { action: "task_mute"; localSessionId: string; enabled?: boolean }
+  | { action: "task_shell"; localSessionId: string; command: string }
+  | { action: "task_directory"; localSessionId: string; directory?: string; page?: number }
+  | { action: "task_send_file"; localSessionId: string; filePath: string }
   | {
       action: "task_new_group";
       localSessionId: string;
@@ -50,6 +100,66 @@ export interface TaskGroupControlData {
   task: SessionRecord;
 }
 
+export interface TaskForkControlData {
+  sourceLocalSessionId: string;
+  sourceTurnId: string;
+  task: SessionRecord;
+}
+
+export interface TaskAgentControlData {
+  current: string;
+  agents: Array<{ name: string; title: string }>;
+}
+
+export interface TaskSettingsControlData {
+  session: SessionRecord;
+  providers: ModelProviderOption[];
+  models: ModelOption[];
+  reasoningOptions: ReasoningEffortOption[];
+  permissionModes: PermissionMode[];
+}
+
+export interface TaskGoalControlData {
+  goal?: RuntimeGoal;
+  cleared?: boolean;
+}
+
+export interface TaskTurnControlEntry {
+  sequence: number;
+  turnId: string;
+  parentTurnId?: string;
+  prompt?: string;
+  startedAt?: number;
+  completedAt?: number;
+  current: boolean;
+}
+
+export interface TaskTurnsControlData {
+  session: SessionRecord;
+  turns: TaskTurnControlEntry[];
+}
+
+export interface TaskMuteControlData {
+  contextKey: string;
+  enabled: boolean;
+}
+
+export type TaskDirectoryEntryKind = "directory" | "image" | "binary" | "file" | "drive";
+
+export interface TaskDirectoryControlData {
+  directory: string;
+  parentDirectory?: string;
+  page: number;
+  totalPages: number;
+  totalEntries: number;
+  entries: Array<{ name: string; path: string; kind: TaskDirectoryEntryKind }>;
+}
+
+export interface TaskShellControlData extends ShellCommandResult {
+  cwd: string;
+  command: string;
+}
+
 export function controlEndpoint(sqlitePath: string): string {
   const resolvedPath = path.resolve(sqlitePath);
   const key = createHash("sha256").update(resolvedPath.toLowerCase()).digest("hex").slice(0, 16);

package/src/cli/help.ts

@@ -11,23 +11,45 @@ export function renderCliHelp(version: string, language: CliLanguage = cliLangua
 常用命令：
   init                              检查并配置 Agent，初始化飞书应用和服务
   init --reset                      重置并重新配置显式指定的 Profile
+  update                            安全更新 npm 安装的 Agent Bot
   console                           打开本地控制台
   server start                      在后台启动 Agent Bot
   server status                     显示服务、飞书 App ID、Agent 进程和安全重启状态
+  server autostart <操作>           管理当前 Profile 的系统自启动
   server restart [--task <任务>]    安排安全重启并将状态发回指定任务会话
   server stop                       停止 Agent Bot
-  task list                         列出任务
-  task current [--json]             显示当前调用任务的详情
-  task status <任务>                显示任务状态
-  task chat <任务>                  显示任务绑定的飞书会话
-  task prompt <任务> <提示词>       向任务发送提示词
-  task newgroup <任务> [标题]       创建新群；支持 --agent、--dir、--nodir
-  task forkgroup <任务> [标题]      从任务 Fork 新群
-  task stop <任务>                  停止任务
-  task title <任务> <标题>          重命名任务
   skills status                     显示内置 Skill 状态
   skills install                    安装内置 Skill
 
+任务命令：
+  task list                         列出任务；支持 --search，sessions 是别名
+  task current [--json]             显示当前调用任务的详情
+  task status|chat [任务]           显示任务状态或绑定的飞书会话
+  task prompt [任务] <提示词>       向任务发送提示词；send 是别名
+  task new [任务] [标题]            在同一会话新建任务；支持 --agent、--dir、--nodir
+  task newgroup [任务] [标题]       创建新群；支持 --agent、--dir、--nodir
+  task fork [任务]                  从任务最近完成的 Turn 创建分支
+  task forkgroup [任务] [标题]      从任务 Fork 新群
+  task switch [任务] [目标任务]     切换会话任务；--previous 切回上一任务
+  task queue [任务] <提示词>        将提示词排队；nosteer 是别名
+  task agent [任务] [名称]          查看或设置该会话的新任务默认 Agent
+  task provider|model [任务] [值]    查看选项或设置 Provider、模型
+  task thinking [任务] [强度]       查看或设置思考强度
+  task permissions [任务] [模式]    查看或设置权限模式：auto、confirm
+  task goal [任务] [操作或目标]     查看、设置、修改、暂停、恢复或清除 Goal
+  task turns [任务]                 列出已完成的历史 Turn
+  task reset [任务] <Turn ID>       将对话上下文 Reset 到指定 Turn
+  task mute [任务] [on|off]         设置群聊仅 @ 响应模式；不传值等同于 on
+  task dir [任务] [目录]            浏览任务目录；支持 --page、--json
+  task file [任务] <路径>           将文件发送到任务绑定的飞书会话
+  task shell [任务] <命令>          在任务目录执行本地命令
+  task stop [任务]                  停止任务
+  task archive [任务]               归档任务
+  task title [任务] <标题>          重命名任务
+  task restart [任务] [--force]     从任务会话请求安全或立即重启
+
+  在 Agent Bot 启动的 Agent 中可省略任务，CLI 会自动使用当前任务；--task <任务> 可显式覆盖。
+
 选项：
   --profile <目录>                  使用独立的 Profile 目录
   --config <路径>                   使用指定的配置文件
@@ -40,17 +62,32 @@ export function renderCliHelp(version: string, language: CliLanguage = cliLangua
   --skip-feishu                     仅初始化 Console 环境
   --reconfigure-feishu              仅替换现有飞书凭据
 
+更新选项：
+  --alpha                           更新到 Alpha 通道
+  --stable                          更新到稳定通道
+  --version <版本>                  更新到指定版本
+  --task <任务>                     将更新和重启状态发回任务所在会话
+  --allow-downgrade                 明确允许安装较旧版本
+
 重启选项：
   --task <任务>                     将安全重启状态发回任务所在会话
   --reason <原因>                   设置重启原因
   --immediate                       立即重启，可能中断任务
 
+自启动操作：
+  server autostart enable           在用户登录时自动启动当前 Profile
+  server autostart enable --linger  Linux：系统启动时自动启动，无需登录
+  server autostart status           显示系统启动项及服务运行状态
+  server autostart disable          移除启动项，不停止当前服务
+
 示例：
   agentbot init
+  agentbot update
   agentbot --profile ~/.agent-bot init --reset
   agentbot --profile ~/.agent-bot-rescue init
   agentbot server start
   agentbot server status
+  agentbot server autostart enable
   agentbot task list
   agentbot server restart --reason "更新 Agent Bot"
 `;
@@ -65,23 +102,45 @@ Usage:
 Common commands:
   init                              Check and configure Agents; initialize the Lark app and service
   init --reset                      Reset and reconfigure an explicit profile
+  update                            Safely update an npm-installed Agent Bot
   console                           Open the local console
   server start                      Start Agent Bot in the background
   server status                     Show the server, Lark App ID, Agent processes, and safe-restart status
+  server autostart <action>         Manage OS autostart for the selected Profile
   server restart [--task <task>]    Schedule a safe restart and return status to the task's conversation
   server stop                       Stop Agent Bot
-  task list                         List tasks
-  task current [--json]             Show details for the task invoking the CLI
-  task status <task>                Show task status
-  task chat <task>                  Show the task's Lark chat binding
-  task prompt <task> <prompt>       Send a Prompt to a task
-  task newgroup <task> [title]      Create a group; supports --agent, --dir, --nodir
-  task forkgroup <task> [title]     Fork a task into a new group
-  task stop <task>                  Stop a task
-  task title <task> <title>         Rename a task
   skills status                     Show the built-in Skill status
   skills install                    Install the built-in Skill
 
+Task commands:
+  task list                         List tasks; supports --search; sessions is an alias
+  task current [--json]             Show details for the task invoking the CLI
+  task status|chat [task]           Show task status or its Lark chat binding
+  task prompt [task] <prompt>       Send a Prompt to a task; send is an alias
+  task new [task] [title]           Create a task in the same conversation; supports --agent, --dir, --nodir
+  task newgroup [task] [title]      Create a group; supports --agent, --dir, --nodir
+  task fork [task]                  Fork the task's latest completed Turn
+  task forkgroup [task] [title]     Fork a task into a new group
+  task switch [task] [target]       Switch the conversation task; --previous selects the prior task
+  task queue [task] <prompt>        Queue a Prompt; nosteer is an alias
+  task agent [task] [name]          Show or set the conversation's default Agent for new tasks
+  task provider|model [task] [value]  Show choices or set the Provider or model
+  task thinking [task] [effort]     Show or set reasoning effort
+  task permissions [task] [mode]    Show or set permission mode: auto or confirm
+  task goal [task] [action|goal]    Show, set, edit, pause, resume, or clear a Goal
+  task turns [task]                 List completed historical Turns
+  task reset [task] <Turn ID>       Reset conversation context to a Turn
+  task mute [task] [on|off]         Set group mention-only mode; omitted means on
+  task dir [task] [directory]       Browse task files; supports --page and --json
+  task file [task] <path>           Send a file to the task's Lark conversation
+  task shell [task] <command>       Run a local command in the task directory
+  task stop [task]                  Stop a task
+  task archive [task]               Archive a task
+  task title [task] <title>         Rename a task
+  task restart [task] [--force]     Request a safe or immediate restart from a task
+
+  Inside an Agent started by Agent Bot, omit task to use the current task; --task <task> overrides it.
+
 Options:
   --profile <directory>             Use an isolated profile directory
   --config <path>                   Use a specific config file
@@ -94,17 +153,32 @@ Init options:
   --skip-feishu                     Initialize for Console only
   --reconfigure-feishu              Replace only the existing Lark credentials
 
+Update options:
+  --alpha                           Update from the Alpha channel
+  --stable                          Update from the stable channel
+  --version <version>               Update to an exact version
+  --task <task>                     Return update and restart status to the task's conversation
+  --allow-downgrade                 Explicitly allow an older version
+
 Restart options:
   --task <task>                     Return safe-restart status to the task's conversation
   --reason <reason>                 Set the restart reason
   --immediate                       Restart immediately and possibly interrupt tasks
 
+Autostart actions:
+  server autostart enable           Start this Profile automatically at user login
+  server autostart enable --linger  Linux: start at system boot without a login
+  server autostart status           Show OS registration and live server state
+  server autostart disable          Remove registration without stopping the current server
+
 Examples:
   agentbot init
+  agentbot update
   agentbot --profile ~/.agent-bot init --reset
   agentbot --profile ~/.agent-bot-rescue init
   agentbot server start
   agentbot server status
+  agentbot server autostart enable
   agentbot task list
   agentbot server restart --reason "Update Agent Bot"
 `;

package/src/cli/taskGroupOptions.ts

@@ -9,6 +9,8 @@ export interface TaskNewGroupOptions {
   json: boolean;
 }
 
+export type TaskNewOptions = TaskNewGroupOptions;
+
 export interface TaskForkGroupOptions {
   reference: string;
   title?: string;
@@ -19,6 +21,14 @@ export function parseTaskNewGroupOptions(
   input: string[],
   language: CliLanguage = cliLanguage,
 ): TaskNewGroupOptions {
+  return parseTaskNewOptions(input, "newgroup", language);
+}
+
+export function parseTaskNewOptions(
+  input: string[],
+  action: "new" | "newgroup" = "new",
+  language: CliLanguage = cliLanguage,
+): TaskNewOptions {
   const positionals: string[] = [];
   let cwd: string | undefined;
   let agentName: string | undefined;
@@ -31,19 +41,19 @@ export function parseTaskNewGroupOptions(
       continue;
     }
     if (argument === "--nodir") {
-      if (projectless) throw optionError("newgroup", "--nodir", language);
-      if (cwd !== undefined) throw conflictingProjectOptions(language);
+      if (projectless) throw optionError(action, "--nodir", language);
+      if (cwd !== undefined) throw conflictingProjectOptions(action, language);
       projectless = true;
       continue;
     }
     if (argument === "--dir") {
-      if (projectless) throw conflictingProjectOptions(language);
-      if (cwd !== undefined) throw optionError("newgroup", "--dir", language);
+      if (projectless) throw conflictingProjectOptions(action, language);
+      if (cwd !== undefined) throw optionError(action, "--dir", language);
       const directory = input[index + 1];
       if (!directory || directory.startsWith("--")) {
         throw new Error(cliText(
-          "task newgroup requires a project directory after --dir.",
-          "task newgroup 需要在 --dir 后指定项目目录。",
+          `task ${action} requires a project directory after --dir.`,
+          `task ${action} 需要在 --dir 后指定项目目录。`,
           language,
         ));
       }
@@ -52,12 +62,12 @@ export function parseTaskNewGroupOptions(
       continue;
     }
     if (argument === "--agent") {
-      if (agentName !== undefined) throw optionError("newgroup", "--agent", language);
+      if (agentName !== undefined) throw optionError(action, "--agent", language);
       const name = input[index + 1];
       if (!name?.trim() || name.startsWith("--")) {
         throw new Error(cliText(
-          "task newgroup requires an Agent standard name after --agent.",
-          "task newgroup 需要在 --agent 后指定 Agent 标准名。",
+          `task ${action} requires an Agent standard name after --agent.`,
+          `task ${action} 需要在 --agent 后指定 Agent 标准名。`,
           language,
         ));
       }
@@ -65,11 +75,11 @@ export function parseTaskNewGroupOptions(
       index += 1;
       continue;
     }
-    if (argument.startsWith("--")) throw unsupportedOption("newgroup", argument, language);
+    if (argument.startsWith("--")) throw unsupportedOption(action, argument, language);
     positionals.push(argument);
   }
   const [reference, ...titleParts] = positionals;
-  requireTaskReference("newgroup", reference, language);
+  requireTaskReference(action, reference, language);
   return {
     reference,
     title: titleParts.join(" ").trim() || undefined,
@@ -104,7 +114,7 @@ export function parseTaskForkGroupOptions(
 }
 
 function requireTaskReference(
-  action: "newgroup" | "forkgroup",
+  action: "new" | "newgroup" | "forkgroup",
   reference: string | undefined,
   language: CliLanguage,
 ): asserts reference is string {
@@ -117,7 +127,7 @@ function requireTaskReference(
 }
 
 function optionError(
-  action: "newgroup",
+  action: "new" | "newgroup",
   option: "--agent" | "--dir" | "--nodir",
   language: CliLanguage,
 ): Error {
@@ -128,16 +138,16 @@ function optionError(
   ));
 }
 
-function conflictingProjectOptions(language: CliLanguage): Error {
+function conflictingProjectOptions(action: "new" | "newgroup", language: CliLanguage): Error {
   return new Error(cliText(
-    "task newgroup cannot combine --dir and --nodir.",
-    "task newgroup 的 --dir 和 --nodir 不能同时使用。",
+    `task ${action} cannot combine --dir and --nodir.`,
+    `task ${action} 的 --dir 和 --nodir 不能同时使用。`,
     language,
   ));
 }
 
 function unsupportedOption(
-  action: "newgroup" | "forkgroup",
+  action: "new" | "newgroup" | "forkgroup",
   option: string,
   language: CliLanguage,
 ): Error {

package/src/cli/taskListOutput.ts

@@ -37,6 +37,16 @@ export function currentAppServerThreadIds(env: NodeJS.ProcessEnv): string[] {
   ].filter((value): value is string => Boolean(value)))];
 }
 
+export function taskCurrentExternalInvocationMessage(
+  language: CliLanguage = cliLanguage,
+): string {
+  return cliText(
+    "agentbot task current is designed for an Agent running inside Agent Bot. A regular terminal has no current Agent task. Use agentbot task list to find a task, then run agentbot task status <task>.",
+    "agentbot task current 是为 Agent Bot 中运行的 Agent 调用设计的。普通终端没有可自动识别的当前 Agent 任务；请先使用 agentbot task list 查找任务，再运行 agentbot task status <任务>。",
+    language,
+  );
+}
+
 export function resolveCurrentTask(
   sessions: SessionRecord[],
   currentThreadIds: readonly string[],