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

package/src/cli.ts

@@ -56,6 +56,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 {
@@ -147,6 +154,7 @@ interface InitCommandResult extends InitializationResult {
     configuration?: EnsureFeishuAppConfigurationResult;
   };
   server: InitializationServerResult;
+  welcome: InitializationWelcomeResult;
 }
 
 interface InitializedAgent extends SupportedAgentInspection {
@@ -162,11 +170,13 @@ 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 });
@@ -189,9 +199,46 @@ 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,
+        language: cliLanguage,
+        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[]> {
@@ -1002,7 +1049,7 @@ 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",
@@ -1079,6 +1126,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,27 @@ export interface StartupStatusView {
   };
 }
 
+export type InitializationWelcomeKind = "first" | "upgrade" | "refresh";
+
+export interface InitializationWelcomeFeature {
+  icon: string;
+  title: string;
+  description: string;
+}
+
+export interface InitializationWelcomeView {
+  kind: InitializationWelcomeKind;
+  language: "en" | "zh";
+  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 +700,128 @@ export class CardRenderer {
     return sectionCard("Agent Bot 已启动", [markdown(lines.join("\n"))], "green");
   }
 
+  renderInitializationWelcome(view: InitializationWelcomeView): Record<string, unknown> {
+    const chinese = view.language === "zh";
+    const title = view.kind === "first"
+      ? (chinese ? "欢迎使用 Agent Bot" : "Welcome to Agent Bot")
+      : view.kind === "upgrade"
+        ? (chinese ? "Agent Bot 已更新" : "Agent Bot is updated")
+        : (chinese ? "Agent Bot 已准备就绪" : "Agent Bot is ready");
+    const subtitle = view.activationPending
+      ? (chinese ? "配置已完成，安全重启后生效" : "Configured and pending a safe restart")
+      : view.kind === "first"
+      ? (chinese ? "本地 Agent 已接入飞书" : "Your local Agents are now available in Lark")
+      : view.kind === "upgrade"
+        ? (chinese ? `新版本 ${view.version} 已生效` : `Version ${view.version} is now active`)
+        : (chinese ? "初始化配置已刷新" : "Initialization settings were refreshed");
+    const activationNote = view.activationPending
+      ? (chinese ? "当前任务完成并安全重启后生效。" : "It will take effect after active work finishes and the safe restart completes.")
+      : undefined;
+    const intro = view.kind === "first"
+      ? (chinese
+          ? "**初始化完成**\n从现在起，你可以直接在飞书里把任务交给本机 Agent，并随时查看进度、切换任务或创建分支。"
+          : "**Setup complete**\nYou can now work with local Agents from Lark, follow progress, switch tasks, and branch conversations.")
+      : view.kind === "upgrade"
+        ? (chinese
+            ? `**升级完成**\n${view.previousVersion ? `${inlineCode(view.previousVersion)} → ` : ""}${inlineCode(view.version)} 已准备好。${activationNote ?? "下面是本版值得关注的能力。"}`
+            : `**Upgrade complete**\n${view.previousVersion ? `${inlineCode(view.previousVersion)} → ` : ""}${inlineCode(view.version)} is ready. ${activationNote ?? "Here is what is new."}`)
+        : (chinese
+            ? `**配置刷新完成**\n${inlineCode(view.version)} 已重新检查配置、Agent 和飞书连接。${activationNote ?? ""}`
+            : `**Configuration refreshed**\n${inlineCode(view.version)} rechecked your configuration, Agents, and Lark connection. ${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(chinese
+            ? `**${view.kind === "upgrade" ? "本版亮点" : "你可以这样使用"}**`
+            : `**${view.kind === "upgrade" ? "What's new" : "What you can do"}**`),
+          ...featureRows,
+          { tag: "hr" },
+          markdown(chinese
+            ? "> 直接发送消息即可开始；发送 `/new` 创建新任务；发送 `/help` 查看全部命令。"
+            : "> Send a message to begin, `/new` for a new task, or `/help` for all commands."),
+          {
+            ...markdown(chinese
+              ? `**版本** ${inlineCode(view.version)}　·　**默认 Agent** ${inlineCode(view.defaultAgentTitle)}　·　**可用 Agent** ${availableAgents}`
+              : `**Version** ${inlineCode(view.version)}　·　**Default Agent** ${inlineCode(view.defaultAgentTitle)}　·　**Available** ${availableAgents}`),
+            text_size: "notation",
+          },
+          {
+            ...markdown(chinese
+              ? "📋 [查看更新日志](https://github.com/keyou/agent-bot/blob/master/CHANGELOG.md)"
+              : "📋 [View Changelog](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);