@downcity/plugins 1.0.215 → 1.0.233

package/src/chat/channels/qq/QQMessageHandler.ts

@@ -8,7 +8,7 @@
  */
 
 import type { Logger } from "@downcity/agent";
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type {
   ChannelChatKeyParams,
   IncomingChatAccessParams,
@@ -38,7 +38,7 @@ export type QqMessageActor = {
   /**
    * QQ 用户 ID / openid。
    */
-  userId?: string;
+  user_id?: string;
   /**
    * QQ 用户展示名。
    */
@@ -52,7 +52,7 @@ export interface QQMessageHandlerOptions {
   /**
    * 当前 agent context。
    */
-  context: AgentContext;
+  context: PluginContext;
   /**
    * 项目根目录。
    */
@@ -66,7 +66,7 @@ export interface QQMessageHandlerOptions {
    */
   getBotUserId(): string;
   /**
-   * 计算 channel chatKey。
+   * 计算 channel chat_key。
    */
   getChatKey(params: ChannelChatKeyParams): string;
   /** 入站 Chat Access 判定。 */
@@ -90,15 +90,15 @@ export interface QQMessageHandlerOptions {
    */
   shouldSkipDuplicatedInboundMessage(
     eventType: string,
-    messageId: string | undefined,
+    message_id: string | undefined,
   ): Promise<boolean>;
   /**
    * Audit 队列写入。
    */
   enqueueAuditMessage(params: {
     chatId: string;
-    messageId?: string;
-    userId?: string;
+    message_id?: string;
+    user_id?: string;
     text: string;
     meta?: ChannelUserMessageMeta;
   }): Promise<void>;
@@ -108,7 +108,7 @@ export interface QQMessageHandlerOptions {
   handleCommand(params: {
     chatId: string;
     chatType: string;
-    messageId: string;
+    message_id: string;
     command: string;
   }): Promise<void>;
   /**
@@ -117,7 +117,7 @@ export interface QQMessageHandlerOptions {
   executeAndReply(params: {
     chatId: string;
     chatType: string;
-    messageId: string;
+    message_id: string;
     instructions: string;
     actor?: QqMessageActor;
     chatTitle?: string;
@@ -140,15 +140,15 @@ export async function handleQqGroupMessage(
 ): Promise<void> {
   const eventType = String(params.eventType || "").trim();
   const data = params.data;
-  const messageId =
+  const message_id =
     typeof data.id === "string" ? data.id.trim() : String(data.id || "").trim();
-  if (!messageId) return;
+  if (!message_id) return;
 
   const groupId = resolveQqGroupChatId(data);
   if (!groupId) {
     options.logger.warn("QQ 群消息缺少 groupId，已忽略", {
       eventType: eventType || EventType.GROUP_MESSAGE_CREATE,
-      messageId,
+      message_id,
     });
     return;
   }
@@ -168,19 +168,19 @@ export async function handleQqC2CMessage(
   options: QQMessageHandlerOptions,
   data: QQMessageData,
 ): Promise<void> {
-  const messageId =
+  const message_id =
     typeof data.id === "string" ? data.id.trim() : String(data.id || "").trim();
-  if (!messageId) return;
+  if (!message_id) return;
 
   const actor = extractQqAuthorIdentity(data.author, data);
   const chatId = resolveQqC2cChatId({
     data,
-    actorUserId: actor.userId,
+    actor_user_id: actor.user_id,
   });
   if (!chatId) {
-    options.logger.warn("QQ C2C 消息缺少 userId，已忽略", {
+    options.logger.warn("QQ C2C 消息缺少 user_id，已忽略", {
       eventType: EventType.C2C_MESSAGE_CREATE,
-      messageId,
+      message_id,
     });
     return;
   }
@@ -201,13 +201,13 @@ export async function handleQqChannelMessage(
   options: QQMessageHandlerOptions,
   data: QQMessageData,
 ): Promise<void> {
-  const { id: messageId, channel_id: channelId, content, author } = data;
-  if (!channelId || !messageId) return;
+  const { id: message_id, channel_id: channelId, content, author } = data;
+  if (!channelId || !message_id) return;
   const chatType = "channel";
   if (
     await options.shouldSkipDuplicatedInboundMessage(
       EventType.AT_MESSAGE_CREATE,
-      messageId,
+      message_id,
     )
   ) {
     return;
@@ -226,15 +226,15 @@ export async function handleQqChannelMessage(
     chatId: channelId,
     chatType,
     chatTitle,
-    userId: actor.userId,
+    user_id: actor.user_id,
     username: actor.username,
   });
   if (!access_result.allowed) return;
 
   const botUserId = options.getBotUserId();
-  if (actor.userId && botUserId && actor.userId === botUserId) {
+  if (actor.user_id && botUserId && actor.user_id === botUserId) {
     options.logger.debug("忽略机器人自身消息（channel）", {
-      messageId,
+      message_id,
       channelId,
       botUserId,
     });
@@ -247,7 +247,7 @@ export async function handleQqChannelMessage(
     await options.handleCommand({
       chatId: channelId,
       chatType: "channel",
-      messageId,
+      message_id,
       command: userMessage,
     });
     return;
@@ -257,8 +257,8 @@ export async function handleQqChannelMessage(
     context: options.context,
     rootPath: options.rootPath,
     chatId: channelId,
-    chatKey: options.getChatKey({ chatId: channelId, chatType }),
-    messageId,
+    chat_key: options.getChatKey({ chatId: channelId, chatType }),
+    message_id,
     userMessage,
     attachments: incomingAttachments,
     getAuthToken: () => options.getAuthToken(),
@@ -268,7 +268,7 @@ export async function handleQqChannelMessage(
   await options.executeAndReply({
     chatId: channelId,
     chatType: "channel",
-    messageId,
+    message_id,
     instructions,
     actor,
     chatTitle,
@@ -290,24 +290,24 @@ async function handleQqInboundMessage(
 ): Promise<void> {
   const eventType = String(params.eventType || "").trim();
   const chatId = String(params.chatId || "").trim();
-  const messageId =
+  const message_id =
     typeof params.data.id === "string"
       ? params.data.id.trim()
       : String(params.data.id || "").trim();
-  if (!chatId || !messageId) return;
+  if (!chatId || !message_id) return;
 
-  if (await options.shouldSkipDuplicatedInboundMessage(eventType, messageId)) {
+  if (await options.shouldSkipDuplicatedInboundMessage(eventType, message_id)) {
     return;
   }
 
   const actor = params.actor || extractQqAuthorIdentity(params.data.author, params.data);
   const chatType = params.chatType;
-  if (!actor.userId) {
-    options.logger.warn("QQ 入站消息缺少发送者 userId，已忽略", {
+  if (!actor.user_id) {
+    options.logger.warn("QQ 入站消息缺少发送者 user_id，已忽略", {
       eventType,
       chatId,
       chatType,
-      messageId,
+      message_id,
     });
     return;
   }
@@ -318,7 +318,7 @@ async function handleQqInboundMessage(
     actorName: actor.username,
   });
   const isGroup = chatType === "group";
-  const chatKey = options.getChatKey({ chatId, chatType });
+  const chat_key = options.getChatKey({ chatId, chatType });
   const rawContent = String(params.data.content || "");
   const incomingAttachments = extractQqInboundAttachments(params.data);
   const hasIncomingAttachment = incomingAttachments.length > 0;
@@ -331,7 +331,7 @@ async function handleQqInboundMessage(
     chatId,
     chatType,
     chatTitle,
-    userId: actor.userId,
+    user_id: actor.user_id,
     username: actor.username,
   });
   if (!access_result.allowed) {
@@ -348,8 +348,8 @@ async function handleQqInboundMessage(
   const enqueueAudit = async (opts: { reason: string; kind?: string }): Promise<void> => {
     await options.enqueueAuditMessage({
       chatId,
-      messageId,
-      userId: actor.userId,
+      message_id,
+      user_id: actor.user_id,
       text: buildQqAuditText({
         rawContent,
         cleanedText,
@@ -366,12 +366,12 @@ async function handleQqInboundMessage(
     });
   };
 
-  if (actor.userId && botUserId && actor.userId === botUserId) {
+  if (actor.user_id && botUserId && actor.user_id === botUserId) {
     if (isGroup) {
       await enqueueAudit({ reason: "bot_originated" });
     }
     options.logger.debug("忽略机器人自身消息", {
-      messageId,
+      message_id,
       chatId,
       chatType,
       botUserId,
@@ -396,7 +396,7 @@ async function handleQqInboundMessage(
     await options.handleCommand({
       chatId,
       chatType,
-      messageId,
+      message_id,
       command: cleanedText,
     });
     return;
@@ -411,8 +411,8 @@ async function handleQqInboundMessage(
     context: options.context,
     rootPath: options.rootPath,
     chatId,
-    chatKey,
-    messageId,
+    chat_key,
+    message_id,
     userMessage: cleanedText,
     attachments: incomingAttachments,
     getAuthToken: () => options.getAuthToken(),
@@ -425,7 +425,7 @@ async function handleQqInboundMessage(
   await options.executeAndReply({
     chatId,
     chatType,
-    messageId,
+    message_id,
     instructions,
     actor,
     chatTitle,

package/src/chat/channels/qq/QQSendSupport.ts

@@ -75,9 +75,9 @@ export function isRetryableQqSendFailure(errorText: string): boolean {
  */
 export async function waitBeforeQqSendRetry(attempt: number): Promise<void> {
   const safeAttempt = Number.isFinite(attempt) && attempt > 0 ? Math.trunc(attempt) : 1;
-  const delayMs = Math.min(4000, 600 * 2 ** (safeAttempt - 1));
+  const delay_ms = Math.min(4000, 600 * 2 ** (safeAttempt - 1));
   const jitterMs = Math.floor(Math.random() * 180);
-  await sleepMs(delayMs + jitterMs);
+  await sleepMs(delay_ms + jitterMs);
 }
 
 /**

package/src/chat/channels/qq/QQSupport.ts

@@ -7,7 +7,7 @@
  */
 
 import { buildChatInboundText, augmentChatInboundInput } from "@/chat/runtime/InboundAugment.js";
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { JsonObject } from "@downcity/agent";
 import type { QQMessageData, QQReadyUser } from "@/chat/channels/qq/types/QqChannel.js";
 import type { QqIncomingAttachment } from "@/chat/types/QqVoice.js";
@@ -52,7 +52,7 @@ export interface BuildQqInboundInstructionsParams {
   /**
    * 当前执行上下文。
    */
-  context: AgentContext;
+  context: PluginContext;
   /**
    * 项目根目录。
    */
@@ -64,11 +64,11 @@ export interface BuildQqInboundInstructionsParams {
   /**
    * chat queue key。
    */
-  chatKey: string;
+  chat_key: string;
   /**
    * 当前消息 id。
    */
-  messageId: string;
+  message_id: string;
   /**
    * 用户文本。
    */
@@ -185,11 +185,11 @@ export function resolveQqGroupChatId(data: QQMessageData): string {
  */
 export function resolveQqC2cChatId(params: {
   data: QQMessageData;
-  actorUserId?: string;
+  actor_user_id?: string;
 }): string {
-  const { data, actorUserId } = params;
+  const { data, actor_user_id } = params;
   return [
-    actorUserId,
+    actor_user_id,
     data.user_openid,
     data.openid,
     data.author_id,
@@ -252,10 +252,10 @@ export async function buildQqInboundInstructions(
       input: {
         channel: "qq",
         chatId: params.chatId,
-        chatKey: params.chatKey,
-        messageId: params.messageId,
+        chat_key: params.chat_key,
+        message_id: params.message_id,
         rootPath: params.rootPath,
-        bodyText: text || undefined,
+        body_text: text || undefined,
         attachments: resolvedAttachments,
       },
     }),

package/src/chat/channels/qq/types/QqChannel.ts

@@ -400,7 +400,7 @@ export interface QqActorIdentity {
   /**
    * 归一化后的用户 ID。
    */
-  userId?: string;
+  user_id?: string;
   /**
    * 归一化后的展示名。
    */

package/src/chat/channels/telegram/ApiClient.ts

@@ -40,9 +40,9 @@ export class TelegramApiClient {
   private readonly rootPath: string;
   private readonly logger: Logger;
 
-  constructor(opts: { botToken: string; projectRoot: string; logger: Logger }) {
+  constructor(opts: { botToken: string; project_root: string; logger: Logger }) {
     this.botToken = opts.botToken;
-    this.rootPath = opts.projectRoot;
+    this.rootPath = opts.project_root;
     this.logger = opts.logger;
   }
 
@@ -134,7 +134,7 @@ export class TelegramApiClient {
           throw error;
         }
 
-        const delayMs =
+        const delay_ms =
           TELEGRAM_SEND_RETRY_DELAYS_MS[attempt] ||
           TELEGRAM_SEND_RETRY_DELAYS_MS[
             TELEGRAM_SEND_RETRY_DELAYS_MS.length - 1
@@ -142,10 +142,10 @@ export class TelegramApiClient {
         this.logger.warn("Telegram send failed, retrying", {
           method,
           attempt: attempt + 1,
-          retryInMs: delayMs,
+          retryInMs: delay_ms,
           error: String(error),
         });
-        await sleep(delayMs);
+        await sleep(delay_ms);
       }
     }
 
@@ -344,7 +344,7 @@ export class TelegramApiClient {
    */
   async setMessageReaction(
     chatId: string,
-    messageId: number,
+    message_id: number,
     opts?: { emoji?: string; isBig?: boolean },
   ): Promise<void> {
     const emoji =
@@ -353,7 +353,7 @@ export class TelegramApiClient {
         : "👍";
     await this.requestJson("setMessageReaction", {
       chat_id: chatId,
-      message_id: messageId,
+      message_id: message_id,
       reaction: [{ type: "emoji", emoji }],
       ...(opts?.isBig === true ? { is_big: true } : {}),
     });

package/src/chat/channels/telegram/Bot.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - `TelegramBot` 只保留入站授权、命令分发、消息入队与回复编排。
  * - polling、runtime 状态、webhook 清理、自愈重试已下沉到 `TelegramPlatformClient`。
- * - chatKey / audit / mention 清理 / 附件保存已下沉到 `TelegramInbound`。
+ * - chat_key / audit / mention 清理 / 附件保存已下沉到 `TelegramInbound`。
  */
 
 import { BaseChatChannel } from "@/chat/channels/BaseChatChannel.js";
@@ -22,7 +22,7 @@ import {
   type TelegramUpdate,
   type TelegramUser,
 } from "./Shared.js";
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { JsonObject } from "@downcity/agent";
 import type { ChatChannelTestResult } from "@/chat/types/ChannelStatus.js";
 import {
@@ -50,7 +50,7 @@ export class TelegramBot extends BaseChatChannel {
   private startTask: Promise<void> | null = null;
   private startupGeneration = 0;
 
-  constructor(context: AgentContext, botToken: string) {
+  constructor(context: PluginContext, botToken: string) {
     super({ channel: "telegram", context });
     this.botToken = botToken;
     this.platform = new TelegramPlatformClient({
@@ -99,8 +99,8 @@ export class TelegramBot extends BaseChatChannel {
     params: ChannelSendTextParams,
   ): Promise<void> {
     const replyToMessageId =
-      params.replyToMessage === true
-        ? parseTelegramMessageId(params.messageId)
+      params.reply_to_message === true
+        ? parseTelegramMessageId(params.message_id)
         : undefined;
     await this.sendMessage(params.chatId, params.text, {
       messageThreadId: params.messageThreadId,
@@ -122,13 +122,13 @@ export class TelegramBot extends BaseChatChannel {
     }
     if (params.action !== "react") return;
 
-    const messageId = parseTelegramMessageId(params.messageId);
-    if (!messageId) {
+    const message_id = parseTelegramMessageId(params.message_id);
+    if (!message_id) {
       throw new Error(
-        "Telegram reaction requires a numeric messageId. Provide --message-id or ensure chat meta has latest messageId.",
+        "Telegram reaction requires a numeric message_id. Provide --message-id or ensure chat meta has latest message_id.",
       );
     }
-    await this.platform.setMessageReaction(params.chatId, messageId, {
+    await this.platform.setMessageReaction(params.chatId, message_id, {
       emoji: params.reactionEmoji,
       isBig: params.reactionIsBig === true,
     });
@@ -240,8 +240,8 @@ export class TelegramBot extends BaseChatChannel {
         enqueueAuditMessage: async (params) => {
           await this.enqueueAuditMessage(params);
         },
-        runInChat: async (chatKey, fn) => {
-          await this.runInChat(chatKey, fn);
+        runInChat: async (chat_key, fn) => {
+          await this.runInChat(chat_key, fn);
         },
         handleCommand: async (params) => {
           await this.handleCommand(
@@ -257,7 +257,7 @@ export class TelegramBot extends BaseChatChannel {
             params.instructions,
             params.from,
             params.chatTitle,
-            params.messageId,
+            params.message_id,
             params.chatType,
             params.messageThreadId,
             params.receivedAt,
@@ -328,22 +328,22 @@ export class TelegramBot extends BaseChatChannel {
     instructions: string,
     from?: TelegramUser,
     chatTitle?: string,
-    messageId?: string,
+    message_id?: string,
     chatType?: NonNullable<TelegramUpdate["message"]>["chat"]["type"],
     messageThreadId?: number,
     receivedAt?: string,
     extra?: JsonObject,
   ): Promise<void> {
     try {
-      const userId = from?.id ? String(from.id) : undefined;
+      const user_id = from?.id ? String(from.id) : undefined;
       const username = from?.username ? String(from.username) : undefined;
       await this.enqueueMessage({
         chatId,
         text: instructions,
         chatType,
-        messageId,
+        message_id,
         messageThreadId,
-        userId,
+        user_id,
         username,
         receivedAt,
         chatTitle,
@@ -393,7 +393,7 @@ export class TelegramBot extends BaseChatChannel {
  */
 export function createTelegramBot(
   config: TelegramConfig,
-  context: AgentContext,
+  context: PluginContext,
 ): TelegramBot | null {
   if (!config.enabled || !config.botToken || config.botToken === "${}") {
     return null;

package/src/chat/channels/telegram/BotInfo.ts

@@ -70,8 +70,8 @@ export class TelegramBotInfoProvider implements ChatChannelBotInfoProvider {
     const fullName = [firstName, lastName].filter(Boolean).join(" ").trim();
 
     const name = pickFirstNonEmpty([
-      username ? `@${username.replace(/^@+/, "")}` : "",
       fullName,
+      username ? `@${username.replace(/^@+/, "")}` : "",
       botUserId ? `Telegram Bot ${botUserId.slice(-6)}` : "",
       "Telegram Bot",
     ]);

package/src/chat/channels/telegram/ReplyContext.ts

@@ -57,7 +57,7 @@ export function extractTelegramReplyContext(
   const replied = message?.reply_to_message;
   if (!replied) return undefined;
 
-  const messageId =
+  const message_id =
     typeof replied.message_id === "number" && Number.isFinite(replied.message_id)
       ? String(replied.message_id)
       : undefined;
@@ -66,9 +66,9 @@ export function extractTelegramReplyContext(
   const quoteText =
     typeof message?.quote?.text === "string" ? message.quote.text.trim() : undefined;
 
-  if (!messageId && !actorName && !text && !quoteText) return undefined;
+  if (!message_id && !actorName && !text && !quoteText) return undefined;
   return {
-    ...(messageId ? { messageId } : {}),
+    ...(message_id ? { message_id } : {}),
     ...(actorName ? { actorName } : {}),
     ...(text ? { text } : {}),
     ...(quoteText ? { quoteText } : {}),

package/src/chat/channels/telegram/Shared.ts

@@ -1,5 +1,5 @@
 import path from "path";
-import { parseChatMessageMarkup } from "@downcity/agent";
+import { parse_chat_message_markup } from "@downcity/agent";
 
 /**
  * Telegram 集成配置。
@@ -257,7 +257,7 @@ export function parseTelegramAttachments(text: string): {
       }
   >;
 } {
-  const parsed = parseChatMessageMarkup(text);
+  const parsed = parse_chat_message_markup(text);
   const attachments: Array<{
     type: TelegramAttachmentType;
     pathOrUrl: string;
@@ -336,7 +336,7 @@ export function parseTelegramAttachments(text: string): {
     });
   }
 
-  return { text: parsed.bodyText, attachments, segments };
+  return { text: parsed.body_text, attachments, segments };
 }
 
 function formatActorName(name: string): string {

package/src/chat/channels/telegram/StateStore.ts

@@ -19,8 +19,8 @@ import type { JsonObject } from "@downcity/agent";
 export class TelegramStateStore {
   private readonly lastUpdateIdFile: string;
 
-  constructor(projectRoot: string) {
-    const dir = path.join(projectRoot, ".downcity", ".cache", "telegram");
+  constructor(project_root: string) {
+    const dir = path.join(project_root, ".downcity", ".cache", "telegram");
     this.lastUpdateIdFile = path.join(dir, "lastUpdateId.json");
   }
 

package/src/chat/channels/telegram/TelegramInbound.ts

@@ -2,14 +2,14 @@
  * TelegramInbound：Telegram 入站辅助逻辑。
  *
  * 关键点（中文）
- * - 只负责消息 ID 解析、chatKey 构造、审计文本、mention 清理、附件保存。
+ * - 只负责消息 ID 解析、chat_key 构造、审计文本、mention 清理、附件保存。
  * - 不承担授权、命令分发、消息入队等主流程职责。
  */
 
 import type { TelegramAttachmentType, TelegramUpdate } from "./Shared.js";
 
 /**
- * 构建 lane 维度 chatKey。
+ * 构建 lane 维度 chat_key。
  */
 export function buildTelegramChatKey(
   chatId: string,
@@ -28,8 +28,8 @@ export function buildTelegramChatKey(
 /**
  * 解析 Telegram 消息 ID。
  */
-export function parseTelegramMessageId(messageId?: string): number | undefined {
-  const raw = String(messageId || "").trim();
+export function parseTelegramMessageId(message_id?: string): number | undefined {
+  const raw = String(message_id || "").trim();
   if (!raw || !/^\d+$/.test(raw)) return undefined;
   const parsed = Number.parseInt(raw, 10);
   if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed <= 0) {