@keyou007/agent-bot 0.1.15 → 0.1.16-alpha.1

package/src/cli/FeishuConfigurationFeatures.ts

@@ -0,0 +1,110 @@
+import type { MissingFeishuAppConfiguration } from "./FeishuAppConfiguration.js";
+import { cliLanguage, cliText, type CliLanguage } from "./i18n.js";
+
+interface LocalizedFeatureDescription {
+  en: string;
+  zh: string;
+}
+
+export interface FeishuConfigurationFeature {
+  item: string;
+  feature: string;
+}
+
+const FEATURE_DESCRIPTIONS: Readonly<Record<string, LocalizedFeatureDescription>> = {
+  "application:application:self_manage": {
+    en: "allowing Agent Bot to inspect and complete this Lark app's configuration during initialization",
+    zh: "允许 Agent Bot 在初始化时检查并补全当前飞书应用配置",
+  },
+  "im:chat:create": {
+    en: "creating Lark groups with /newgroup and /forkgroup",
+    zh: "使用 /newgroup 和 /forkgroup 创建飞书群",
+  },
+  "im:chat:delete": {
+    en: "dissolving task groups with /dismiss",
+    zh: "使用 /dismiss 解散任务群",
+  },
+  "im:chat:read": {
+    en: "reading group information and synchronizing task titles after group renames",
+    zh: "读取群信息，并在群重命名后同步任务标题",
+  },
+  "im:message.group_msg": {
+    en: "responding to ordinary group messages that do not mention the bot",
+    zh: "响应未 @ 机器人的普通群消息",
+  },
+  "im:message.p2p_msg:readonly": {
+    en: "receiving and responding to private messages",
+    zh: "接收并响应私聊消息",
+  },
+  "im:message.reactions:write_only": {
+    en: "showing message-processing status with reactions",
+    zh: "使用 Reaction 显示消息处理状态",
+  },
+  "im:message:readonly": {
+    en: "reading referenced, forwarded, and image messages",
+    zh: "读取引用消息、转发消息和图片消息",
+  },
+  "im:message:send_as_bot": {
+    en: "sending Agent Bot replies, cards, files, and notifications",
+    zh: "发送 Agent Bot 回复、卡片、文件和通知",
+  },
+  "im:message:update": {
+    en: "updating sent progress cards",
+    zh: "更新已发送的进度卡片",
+  },
+  "im:resource": {
+    en: "uploading and downloading images or files, and setting group avatars",
+    zh: "上传和下载图片或文件，以及设置群头像",
+  },
+  "im.message.receive_v1": {
+    en: "receiving private, group, and topic messages",
+    zh: "接收私聊、群聊和话题消息",
+  },
+  "im.chat.updated_v1": {
+    en: "detecting group renames and synchronizing task titles",
+    zh: "感知群名称变更并同步任务标题",
+  },
+  "card.action.trigger": {
+    en: "using card buttons and interactive actions",
+    zh: "使用卡片按钮和交互操作",
+  },
+};
+
+export function feishuConfigurationFeatures(
+  missing: MissingFeishuAppConfiguration,
+  language: CliLanguage = cliLanguage,
+): FeishuConfigurationFeature[] {
+  return [...missing.scopes, ...missing.events, ...missing.callbacks].map((item) => ({
+    item,
+    feature: localizeFeature(item, language),
+  }));
+}
+
+export function formatFeishuConfigurationFeatureIntroduction(
+  missing: MissingFeishuAppConfiguration,
+  language: CliLanguage = cliLanguage,
+): string {
+  const features = feishuConfigurationFeatures(missing, language);
+  if (features.length === 0) return "";
+
+  return [
+    cliText("What this configuration enables:", "这些配置对应的功能：", language),
+    ...features.map(({ item, feature }) => `  ${item}: ${feature}`),
+    "",
+  ].join("\n");
+}
+
+export function feishuAffectedFeatures(
+  missing: MissingFeishuAppConfiguration,
+  language: CliLanguage = cliLanguage,
+): string[] {
+  return [...new Set(feishuConfigurationFeatures(missing, language).map(({ feature }) => feature))];
+}
+
+function localizeFeature(item: string, language: CliLanguage): string {
+  const description = FEATURE_DESCRIPTIONS[item];
+  if (!description) {
+    return cliText("supporting Agent Bot's Lark integration", "支持 Agent Bot 的飞书集成", language);
+  }
+  return cliText(description.en, description.zh, language);
+}

package/src/cli/InitUi.ts

@@ -0,0 +1,135 @@
+import type { Readable, Writable } from "node:stream";
+import {
+  cancel,
+  intro,
+  isCancel,
+  log,
+  multiselect,
+  note,
+  outro,
+  select,
+} from "@clack/prompts";
+import { cliText } from "./i18n.js";
+
+export interface InitUiOption<Value extends string | number> {
+  value: Value;
+  label: string;
+  hint?: string;
+}
+
+export interface InitUiOptions {
+  interactive: boolean;
+  input?: Readable;
+  output?: Writable;
+}
+
+export class InitializationPromptCancelledError extends Error {
+  constructor() {
+    super(cliText("Initialization was cancelled.", "初始化已取消。"));
+    this.name = "InitializationPromptCancelledError";
+  }
+}
+
+export class InitUi {
+  readonly interactive: boolean;
+  private readonly input: Readable;
+  private readonly output: Writable;
+
+  constructor(options: InitUiOptions) {
+    this.interactive = options.interactive;
+    this.input = options.input ?? process.stdin;
+    this.output = options.output ?? process.stderr;
+  }
+
+  start(title: string): void {
+    if (this.interactive) intro(title, this.commonOptions());
+  }
+
+  finish(message: string): void {
+    if (this.interactive) outro(message, this.commonOptions());
+  }
+
+  step(message: string): void {
+    if (this.interactive) log.step(message, this.commonOptions());
+  }
+
+  info(message: string): void {
+    if (this.interactive) log.info(message, this.commonOptions());
+  }
+
+  success(message: string): void {
+    if (this.interactive) log.success(message, this.commonOptions());
+  }
+
+  warn(message: string): void {
+    if (this.interactive) log.warn(message, this.commonOptions());
+  }
+
+  note(title: string, message: string): void {
+    if (this.interactive) note(message, title, this.commonOptions());
+  }
+
+  async select<Value extends string | number>(options: {
+    message: string;
+    options: InitUiOption<Value>[];
+    initialValue?: Value;
+  }): Promise<Value> {
+    this.requireInteractive();
+    const value = await select<string | number>({
+      message: options.message,
+      options: promptOptions(options.options),
+      ...(options.initialValue !== undefined ? { initialValue: options.initialValue } : {}),
+      ...this.commonOptions(),
+    });
+    return this.requireValue(value) as Value;
+  }
+
+  async multiselect<Value extends string | number>(options: {
+    message: string;
+    options: InitUiOption<Value>[];
+    initialValues?: Value[];
+    required?: boolean;
+  }): Promise<Value[]> {
+    this.requireInteractive();
+    const values = await multiselect<string | number>({
+      message: options.message,
+      options: promptOptions(options.options),
+      ...(options.initialValues ? { initialValues: options.initialValues } : {}),
+      ...(options.required !== undefined ? { required: options.required } : {}),
+      ...this.commonOptions(),
+    });
+    return this.requireValue(values) as Value[];
+  }
+
+  private commonOptions(): { input: Readable; output: Writable } {
+    return { input: this.input, output: this.output };
+  }
+
+  private requireInteractive(): void {
+    if (!this.interactive) {
+      throw new Error("Interactive initialization is not available in this terminal.");
+    }
+  }
+
+  private requireValue<Value>(value: Value | symbol): Value {
+    if (!isCancel(value)) return value;
+    cancel(cliText("Initialization cancelled.", "初始化已取消。"), this.commonOptions());
+    throw new InitializationPromptCancelledError();
+  }
+}
+
+function promptOptions<Value extends string | number>(
+  options: InitUiOption<Value>[],
+): Array<InitUiOption<string> | InitUiOption<number>> {
+  return options.map(({ value, label, hint }) => typeof value === "number"
+    ? { value: value as number, label, ...(hint ? { hint } : {}) }
+    : { value: value as string, label, ...(hint ? { hint } : {}) });
+}
+
+export function shouldUseInteractiveInitialization(
+  json: boolean,
+  inputIsTty = process.stdin.isTTY === true,
+  outputIsTty = process.stderr.isTTY === true,
+): boolean {
+  return !json && inputIsTty && outputIsTty;
+}