@keyou007/agent-bot 0.1.13-alpha.2 → 0.1.13-alpha.4

package/src/cli.ts

@@ -18,7 +18,8 @@ import {
   readConfiguredAgentSelection,
   readFeishuCredentials,
   shouldCreateFeishuApp,
-  writeDefaultAgent,
+  shouldConfigureAgentsDuringInitialization,
+  writeConfiguredAgentSelection,
   writeFeishuCredentials,
   type InitializationResult,
   type InitializationStatus,
@@ -49,6 +50,7 @@ import {
 } from "./cli/AgentPrerequisites.js";
 import {
   parseMaintenanceSelection,
+  resolveAgentConfigurationChoices,
   resolveDefaultAgentChoice,
   selectableDefaultAgents,
   type SelectableDefaultAgent,
@@ -56,6 +58,13 @@ import {
 import { formatServerStatus, withConfiguredFeishuAppId } from "./cli/serverStatus.js";
 import { resolveSystemSkillsRoot, SkillRegistry, type SkillRegistrationStatus } from "./cli/SkillRegistry.js";
 import { readPackageVersion } from "./cli/packageVersion.js";
+import {
+  readInitializationReceipt,
+  resolveInitializationWelcomeKind,
+  sendInitializationWelcome,
+  writeInitializationReceipt,
+  type InitializationWelcomeResult,
+} from "./cli/InitializationWelcome.js";
 import { applyExplicitProfile, parseGlobalOptions } from "./cli/profile.js";
 import { printVerificationQrAndLink } from "./cli/VerificationOutput.js";
 import {
@@ -136,6 +145,7 @@ type FeishuInitializationStatus = "created" | "existing" | "skipped";
 
 interface InitCommandResult extends InitializationResult {
   agents: InitializedAgent[];
+  configuredAgents: string[];
   defaultAgent: {
     name: string;
     status: "selected" | "existing";
@@ -147,9 +157,11 @@ interface InitCommandResult extends InitializationResult {
     configuration?: EnsureFeishuAppConfigurationResult;
   };
   server: InitializationServerResult;
+  welcome: InitializationWelcomeResult;
 }
 
 interface InitializedAgent extends SupportedAgentInspection {
+  configured?: boolean;
   assistance?: {
     status: "completed" | "skipped" | "unavailable" | "failed";
     error?: string;
@@ -162,24 +174,37 @@ async function initCommand(
   explicitProfile: boolean,
 ): Promise<void> {
   const options = parseInitCommandOptions(input, explicitProfile);
+  const version = readPackageVersion();
+  const previousInitialization = readInitializationReceipt(agentBotHome());
   let initializationLock = options.reset
     ? acquireInitializationLock(agentBotHome())
     : undefined;
   let paths: InitializationResult;
-  let initialized: Omit<InitCommandResult, "server">;
+  let initialized: Omit<InitCommandResult, "server" | "welcome">;
   try {
     if (options.reset) await assertResetProfileServerStopped(configPath);
     paths = initializeAgentBot({ configPath, reset: options.reset });
     if (!options.json) printInitializationPaths(paths);
-    const agents = await initializeSupportedAgents(options.json);
-    const defaultAgent = await selectDefaultAgent(paths.config.path, agents, options.json);
+    const inspectedAgents = await initializeSupportedAgents(options.json);
+    const defaultAgent = await configureAgentsAndDefault(
+      paths.config.path,
+      inspectedAgents,
+      options.json,
+      shouldConfigureAgentsDuringInitialization(paths.config.status),
+    );
+    const configuredAgents = readConfiguredAgentSelection(paths.config.path).agents.map((agent) => agent.name);
+    const configuredAgentNames = new Set(configuredAgents);
+    const agents = inspectedAgents.map((agent) => ({
+      ...agent,
+      configured: configuredAgentNames.has(agent.id),
+    }));
     initializationLock ??= acquireInitializationLock(paths.home.path);
     cleanupFeishuCredentialTemporaryFiles(paths.env.path);
     const feishu = await initializeFeishu(
       paths,
       options,
     );
-    initialized = { ...paths, agents, defaultAgent, feishu };
+    initialized = { ...paths, agents, configuredAgents, defaultAgent, feishu };
   } finally {
     initializationLock?.release();
   }
@@ -189,9 +214,45 @@ async function initCommand(
     process.stdout.write(cliText("\nStarting Agent Bot server...\n", "\n正在启动 Agent Bot 服务...\n"));
   }
   const server = await startInitializedServer({ skipFeishu: options.skipFeishu, configPath });
-  const result: InitCommandResult = { ...initialized, server };
+  const welcomeKind = resolveInitializationWelcomeKind({
+    firstInitialization: paths.config.status === "created",
+    previousVersion: previousInitialization?.version,
+    currentVersion: version,
+  });
+  let welcome: InitializationWelcomeResult;
+  if (options.skipFeishu) {
+    welcome = { status: "skipped", kind: welcomeKind, reason: "feishu-skipped" };
+  } else {
+    try {
+      welcome = await sendInitializationWelcome({
+        configPath,
+        version,
+        previousVersion: previousInitialization?.version,
+        kind: welcomeKind,
+        activationPending: server.status === "restart-scheduled",
+      });
+    } catch (error) {
+      welcome = {
+        status: "failed",
+        kind: welcomeKind,
+        message: error instanceof Error ? error.message : String(error),
+      };
+    }
+  }
+  try {
+    writeInitializationReceipt(paths.home.path, version);
+  } catch (error) {
+    process.stderr.write(`${cliText(
+      "Warning: Could not save initialization version metadata: ",
+      "警告：无法保存初始化版本信息：",
+    )}${error instanceof Error ? error.message : String(error)}\n`);
+  }
+  const result: InitCommandResult = { ...initialized, server, welcome };
   if (options.json) printJson(result);
-  else printInitializationServerResult(server);
+  else {
+    printInitializationServerResult(server);
+    printInitializationWelcomeResult(welcome);
+  }
 }
 
 async function initializeSupportedAgents(json: boolean): Promise<InitializedAgent[]> {
@@ -277,49 +338,81 @@ async function initializeSupportedAgents(json: boolean): Promise<InitializedAgen
   return initialized;
 }
 
-async function selectDefaultAgent(
+async function configureAgentsAndDefault(
   configPath: string,
   inspections: InitializedAgent[],
   json: boolean,
+  configureAgents: boolean,
 ): Promise<InitCommandResult["defaultAgent"]> {
   const output = json ? process.stderr : process.stdout;
   const configured = readConfiguredAgentSelection(configPath);
-  const choices = selectableDefaultAgents(configured.agents, inspections);
-  if (!process.stdin.isTTY) {
-    if (!configured.defaultAgent || !configured.agents.some((agent) => agent.name === configured.defaultAgent)) {
+  const configuredDefaultIsValid = Boolean(
+    configured.defaultAgent
+    && configured.agents.some((agent) => agent.name === configured.defaultAgent),
+  );
+  if (!configureAgents) {
+    if (!configuredDefaultIsValid) {
       throw new Error(cliText(
-        "A default Agent is not configured. Run agentbot init in an interactive terminal and select one.",
-        "尚未配置默认 Agent。请在交互式终端中运行 agentbot init 并选择一个 Agent。",
+        "The existing Profile has no valid default Agent. Set defaults.agent in config.yaml, then run agentbot init again.",
+        "现有 Profile 没有有效的默认 Agent。请在 config.yaml 中设置 defaults.agent，然后重新运行 agentbot init。",
       ));
     }
     output.write(cliText(
-      `Default Agent: ${configured.defaultAgent} (kept because no interactive terminal is available)\n`,
-      `默认 Agent：${configured.defaultAgent}（当前没有交互式终端，已保留现有设置）\n`,
+      `Default Agent: ${configured.defaultAgent} (unchanged)\n`,
+      `默认 Agent：${configured.defaultAgent}（保持不变）\n`,
     ));
-    return { name: configured.defaultAgent, status: "existing" };
+    return { name: configured.defaultAgent!, status: "existing" };
   }
+
+  const choices = selectableDefaultAgents(configured.agents, inspections);
   if (choices.length === 0) {
     throw new Error(cliText(
-      "No available configured Agent can be selected. Install Codex or TraeX, then run agentbot init again.",
-      "没有可选择的已配置 Agent。请安装 Codex 或 TraeX，然后重新运行 agentbot init。",
+      "No installed supported Agent was detected. Install Codex or TraeX, then run agentbot init again.",
+      "没有检测到已安装且受支持的 Agent。请安装 Codex 或 TraeX，然后重新运行 agentbot init。",
     ));
   }
 
-  output.write(cliText("\nSelect the default Agent:\n", "\n请选择默认 Agent：\n"));
-  for (const [index, choice] of choices.entries()) {
-    const version = choice.installedVersion ? ` (${choice.installedVersion})` : "";
-    const current = choice.name === configured.defaultAgent
-      ? cliText(" [current]", " [当前]")
-      : "";
-    output.write(`  ${index + 1}. ${choice.name} - ${choice.title}${version}${current}\n`);
-  }
-  const selected = choices[await promptForDefaultAgent(choices, configured.defaultAgent)];
-  if (!selected) throw new Error(cliText("Default Agent selection failed.", "默认 Agent 选择失败。"));
-  const updated = writeDefaultAgent(configPath, selected.name);
-  output.write(updated
-    ? cliText(`Saved default Agent: ${selected.name}\n`, `已保存默认 Agent：${selected.name}\n`)
-    : cliText(`Default Agent unchanged: ${selected.name}\n`, `默认 Agent 保持不变：${selected.name}\n`));
-  return { name: selected.name, status: updated ? "selected" : "existing" };
+  let selectedAgents = choices;
+  if (process.stdin.isTTY && choices.length > 1) {
+    output.write(cliText("\nSelect Agents to configure:\n", "\n请选择要配置的 Agent：\n"));
+    for (const [index, choice] of choices.entries()) {
+      output.write(`  ${index + 1}. ${choice.name} - ${choice.title} (${choice.installedVersion})\n`);
+    }
+    const selectedIndexes = await promptForConfiguredAgents(choices);
+    selectedAgents = selectedIndexes.flatMap((index) => choices[index] ? [choices[index]!] : []);
+  }
+
+  const selectedNames = selectedAgents.map((agent) => agent.name);
+  output.write(cliText(
+    `Configured Agents: ${selectedNames.join(", ")}\n`,
+    `已配置 Agent：${selectedNames.join("、")}\n`,
+  ));
+
+  let selectedDefault = selectedAgents[0]!;
+  if (selectedAgents.length > 1) {
+    if (process.stdin.isTTY) {
+      output.write(cliText("\nSelect the default Agent:\n", "\n请选择默认 Agent：\n"));
+      for (const [index, choice] of selectedAgents.entries()) {
+        const current = choice.name === configured.defaultAgent
+          ? cliText(" [current]", " [当前]")
+          : "";
+        output.write(`  ${index + 1}. ${choice.name} - ${choice.title} (${choice.installedVersion})${current}\n`);
+      }
+      selectedDefault = selectedAgents[
+        await promptForDefaultAgent(selectedAgents, configured.defaultAgent)
+      ]!;
+    } else {
+      selectedDefault = selectedAgents.find((agent) => agent.name === configured.defaultAgent)
+        ?? selectedAgents[0]!;
+    }
+  }
+
+  const updated = writeConfiguredAgentSelection(configPath, selectedNames, selectedDefault.name);
+  output.write(cliText(
+    `Default Agent: ${selectedDefault.name}${process.stdin.isTTY ? "" : " (selected automatically)"}\n`,
+    `默认 Agent：${selectedDefault.name}${process.stdin.isTTY ? "" : "（已自动选择）"}\n`,
+  ));
+  return { name: selectedDefault.name, status: updated ? "selected" : "existing" };
 }
 
 function promptForAgentMaintenance(choiceCount: number): Promise<number[]> {
@@ -356,6 +449,40 @@ function promptForAgentMaintenance(choiceCount: number): Promise<number[]> {
   });
 }
 
+function promptForConfiguredAgents(choices: SelectableDefaultAgent[]): Promise<number[]> {
+  const readline = createInterface({ input: process.stdin, output: process.stderr });
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    const finish = (selection: number[]): void => {
+      settled = true;
+      readline.close();
+      resolve(selection);
+    };
+    const ask = (): void => {
+      readline.question(cliText(
+        "Enter numbers or Agent names separated by commas, type all, or press Enter for all: ",
+        "请输入 Agent 编号或标准名（多个用逗号分隔），输入 all 或直接回车选择全部：",
+      ), (answer) => {
+        const selection = resolveAgentConfigurationChoices(answer, choices);
+        if (selection) {
+          finish(selection);
+          return;
+        }
+        process.stderr.write(cliText(
+          `Select at least one Agent using numbers from 1 to ${choices.length} or standard names.\n`,
+          `请使用 1 到 ${choices.length} 之间的编号或标准名，至少选择一个 Agent。\n`,
+        ));
+        ask();
+      });
+    };
+    listenForPromptCancellation(readline, () => {
+      settled = true;
+      reject(new Error(cliText("Initialization was cancelled.", "初始化已取消。")));
+    }, () => settled);
+    ask();
+  });
+}
+
 function promptForDefaultAgent(
   choices: SelectableDefaultAgent[],
   currentAgent?: string,
@@ -1002,11 +1129,12 @@ function printInitializationPaths(result: InitializationResult): void {
   process.stdout.write(`${cliText("Log directory: ", "日志目录：")}${result.logs.path} (${initializationStatusLabel(result.logs.status)})\n`);
 }
 
-function printInitializationResult(result: Omit<InitCommandResult, "server">): void {
+function printInitializationResult(result: Omit<InitCommandResult, "server" | "welcome">): void {
   process.stdout.write(cliText(
     "\nAgent Bot initialization completed.\n",
     "\nAgent Bot 初始化完成。\n",
   ));
+  process.stdout.write(`${cliText("Configured Agents: ", "已配置 Agent：")}${result.configuredAgents.join(", ")}\n`);
   process.stdout.write(`${cliText("Default Agent: ", "默认 Agent：")}${result.defaultAgent.name}\n`);
   if (result.feishu.status === "created") {
     process.stdout.write(cliText(
@@ -1079,6 +1207,29 @@ function printInitializationServerResult(result: InitCommandResult["server"]): v
   printServerStartResult(result);
 }
 
+function printInitializationWelcomeResult(result: InitializationWelcomeResult): void {
+  if (result.status === "sent") {
+    process.stdout.write(cliText(
+      "Welcome card: sent to your Lark private chat.\n",
+      "欢迎卡片：已发送到你的飞书私聊。\n",
+    ));
+    return;
+  }
+  if (result.status === "failed") {
+    process.stderr.write(cliText(
+      `Warning: The private welcome card could not be sent: ${result.message}\n`,
+      `警告：无法发送私聊欢迎卡片：${result.message}\n`,
+    ));
+    return;
+  }
+  if (result.reason === "missing-user-open-id") {
+    process.stderr.write(cliText(
+      "Warning: The private welcome card was skipped because FEISHU_USER_OPEN_ID is not available. Send the bot a private message, then run agentbot init again.\n",
+      "警告：尚未获得 FEISHU_USER_OPEN_ID，无法发送私聊欢迎卡片。请先私聊机器人，再次运行 agentbot init。\n",
+    ));
+  }
+}
+
 function printServerStartResult(result: ServerStartResult): void {
   process.stdout.write(
     result.status === "already-running"

package/src/feishu/CardRenderer.ts

@@ -35,6 +35,26 @@ export interface StartupStatusView {
   };
 }
 
+export type InitializationWelcomeKind = "first" | "upgrade" | "refresh";
+
+export interface InitializationWelcomeFeature {
+  icon: string;
+  title: string;
+  description: string;
+}
+
+export interface InitializationWelcomeView {
+  kind: InitializationWelcomeKind;
+  version: string;
+  previousVersion?: string;
+  activationPending?: boolean;
+  defaultAgentName: string;
+  defaultAgentTitle: string;
+  availableAgents: string[];
+  logoPath: string;
+  features: InitializationWelcomeFeature[];
+}
+
 export interface SafeRestartStatusView {
   scheduleId: number;
   reason: string;
@@ -679,6 +699,113 @@ export class CardRenderer {
     return sectionCard("Agent Bot 已启动", [markdown(lines.join("\n"))], "green");
   }
 
+  renderInitializationWelcome(view: InitializationWelcomeView): Record<string, unknown> {
+    const title = view.kind === "first"
+      ? "欢迎使用 Agent Bot"
+      : view.kind === "upgrade"
+        ? "Agent Bot 已更新"
+        : "Agent Bot 已准备就绪";
+    const subtitle = view.activationPending
+      ? "配置已完成，安全重启后生效"
+      : view.kind === "first"
+      ? "本地 Agent 已接入飞书"
+      : view.kind === "upgrade"
+        ? `新版本 ${view.version} 已生效`
+        : "初始化配置已刷新";
+    const activationNote = view.activationPending
+      ? "当前任务完成并安全重启后生效。"
+      : undefined;
+    const intro = view.kind === "first"
+      ? "**初始化完成**\n从现在起，你可以直接在飞书里把任务交给本机 Agent，并随时查看进度、切换任务或创建分支。"
+      : view.kind === "upgrade"
+        ? `**升级完成**\n${view.previousVersion ? `${inlineCode(view.previousVersion)} → ` : ""}${inlineCode(view.version)} 已准备好。${activationNote ?? "下面是本版值得关注的能力。"}`
+        : `**配置刷新完成**\n${inlineCode(view.version)} 已重新检查配置、Agent 和飞书连接。${activationNote ?? ""}`;
+    const logo = {
+      ...localCardImage(view.logoPath, "Agent Bot logo"),
+      preview: false,
+    };
+    const featureColumns = view.features.slice(0, 4).map((feature) => ({
+      tag: "column",
+      width: "weighted",
+      weight: 1,
+      vertical_align: "top",
+      elements: [markdown([
+        `${feature.icon} **${feature.title}**`,
+        `<font color='grey'>${feature.description}</font>`,
+      ].join("\n"))],
+    }));
+    const featureRows = [0, 2].flatMap((start) => {
+      const columns = featureColumns.slice(start, start + 2);
+      return columns.length > 0
+        ? [{
+            tag: "column_set",
+            flex_mode: "none",
+            horizontal_spacing: "16px",
+            vertical_align: "top",
+            columns,
+          }]
+        : [];
+    });
+    const availableAgents = view.availableAgents.length > 0
+      ? view.availableAgents.map((agent) => inlineCode(agent)).join(" · ")
+      : inlineCode(view.defaultAgentName);
+    return {
+      schema: "2.0",
+      config: {
+        update_multi: true,
+        width_mode: "fill",
+      },
+      header: {
+        template: view.kind === "first" ? "turquoise" : view.kind === "upgrade" ? "blue" : "green",
+        title: { tag: "plain_text", content: title },
+        subtitle: { tag: "plain_text", content: subtitle },
+        padding: "12px 12px 12px 12px",
+      },
+      body: {
+        direction: "vertical",
+        vertical_spacing: "12px",
+        padding: "12px 12px 12px 12px",
+        elements: [
+          {
+            tag: "column_set",
+            flex_mode: "none",
+            horizontal_spacing: "16px",
+            vertical_align: "center",
+            columns: [
+              {
+                tag: "column",
+                width: "weighted",
+                weight: 1,
+                vertical_align: "center",
+                elements: [logo],
+              },
+              {
+                tag: "column",
+                width: "weighted",
+                weight: 3,
+                vertical_align: "center",
+                elements: [markdown(intro)],
+              },
+            ],
+          },
+          { tag: "hr" },
+          markdown(`**${view.kind === "upgrade" ? "本版亮点" : "你可以这样使用"}**`),
+          ...featureRows,
+          { tag: "hr" },
+          markdown("> 直接发送消息即可开始；发送 `/new` 创建新任务；发送 `/help` 查看全部命令。"),
+          {
+            ...markdown(`**版本** ${inlineCode(view.version)}　·　**默认 Agent** ${inlineCode(view.defaultAgentTitle)}　·　**可用 Agent** ${availableAgents}`),
+            text_size: "notation",
+          },
+          {
+            ...markdown("📋 [查看更新日志](https://github.com/keyou/agent-bot/blob/master/CHANGELOG.md)"),
+            text_size: "notation",
+          },
+        ],
+      },
+    };
+  }
+
   renderTurn(state: TurnViewState): Record<string, unknown> {
     const elements = renderTurnElements(state, "hidden");
     if (isTurnStoppable(state.status)) {

package/src/supervision/SafeRestartNotifier.ts

@@ -161,17 +161,7 @@ export class SafeRestartNotifier {
   }
 
   private collectNotificationTargets(status: SafeRestartStatus): void {
-    const requestedTargets: RestartNotificationTarget[] = status.notificationTargets
-      ?? this.store.listChatContexts("p2p").map(({ contextKey }) => ({ contextKey }));
-    const recentTargets: RestartNotificationTarget[] = this.store.listRecentlyActiveChatContexts(
-      new Date(Date.now() - 60_000),
-    )
-      .filter((chat) => !isThreadContextKey(chat.contextKey))
-      .map(({ contextKey }) => ({ contextKey }));
-    for (const target of [
-      ...requestedTargets,
-      ...recentTargets,
-    ]) {
+    for (const target of status.notificationTargets ?? []) {
       const contextKey = target.contextKey.trim();
       if (!contextKey) continue;
       const existing = this.notificationTargets.get(contextKey);