@downcity/plugins 1.0.216 → 1.0.233

package/src/chat/channels/feishu/FeishuMessageHandler.ts

@@ -9,7 +9,7 @@
 
 import path from "path";
 import type { Logger } from "@downcity/agent";
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type {
   IncomingChatAccessParams,
   IncomingChatAccessResult,
@@ -24,7 +24,7 @@ import {
   augmentChatInboundInput,
   buildChatInboundText,
 } from "@/chat/runtime/InboundAugment.js";
-import { renderChatMessageFileTag } from "@downcity/agent";
+import { render_chat_message_file_tag } from "@downcity/agent";
 import { parseFeishuInboundMessage } from "./InboundAttachment.js";
 import {
   extractFeishuSenderIdentity,
@@ -44,7 +44,7 @@ export interface FeishuMessageHandlerOptions {
   /**
    * 当前 agent context。
    */
-  context: AgentContext;
+  context: PluginContext;
   /**
    * 项目根目录。
    */
@@ -54,7 +54,7 @@ export interface FeishuMessageHandlerOptions {
    */
   logger: Logger;
   /**
-   * 构建 chatKey。
+   * 构建 chat_key。
    */
   buildChatKey(chatId: string): string;
   /**
@@ -77,7 +77,7 @@ export interface FeishuMessageHandlerOptions {
    * 下载入站附件。
    */
   downloadIncomingAttachments(params: {
-    messageId: string;
+    message_id: string;
     attachments: ReturnType<typeof parseFeishuInboundMessage>["attachments"];
   }): Promise<FeishuDownloadedAttachment[]>;
   /**
@@ -101,7 +101,7 @@ export interface FeishuMessageHandlerOptions {
   /**
    * 发送入站 ack reaction。
    */
-  sendInboundAckReaction(params: { messageId: string }): Promise<void>;
+  sendInboundAckReaction(params: { message_id: string }): Promise<void>;
   /**
    * 记录已知会话。
    */
@@ -126,16 +126,16 @@ export interface FeishuMessageHandlerOptions {
    */
   buildAccessBlockedText(params: { result: IncomingChatAccessResult }): string;
   /**
-   * 按 chatKey 串行执行。
+   * 按 chat_key 串行执行。
    */
-  runInChat(chatKey: string, fn: () => Promise<void>): Promise<void>;
+  runInChat(chat_key: string, fn: () => Promise<void>): Promise<void>;
   /**
    * 命令处理。
    */
   handleCommand(params: {
     chatId: string;
     chatType: string;
-    messageId: string;
+    message_id: string;
     command: string;
   }): Promise<void>;
   /**
@@ -144,7 +144,7 @@ export interface FeishuMessageHandlerOptions {
   executeAndReply(params: {
     chatId: string;
     chatType: string;
-    messageId: string;
+    message_id: string;
     instructions: string;
     actorId?: string;
     actorName?: string;
@@ -157,7 +157,7 @@ export interface FeishuMessageHandlerOptions {
   sendErrorMessage(params: {
     chatId: string;
     chatType: string;
-    messageId: string;
+    message_id: string;
     errorText: string;
   }): Promise<void>;
 }
@@ -188,10 +188,10 @@ export async function handleFeishuMessage(
     const normalizedMessageId = String(message_id || "").trim();
     if (!normalizedMessageId) return;
     if (!actorId) {
-      options.logger.warn("飞书消息缺少发送者 userId/open_id，已忽略", {
+      options.logger.warn("飞书消息缺少发送者 user_id/open_id，已忽略", {
         chatId: chat_id,
         chatType: chat_type,
-        messageId: normalizedMessageId,
+        message_id: normalizedMessageId,
       });
       return;
     }
@@ -230,7 +230,7 @@ export async function handleFeishuMessage(
           options,
           chatId: chat_id,
           chatType: chat_type,
-          messageId: message_id,
+          message_id: message_id,
           messageType: message_type,
           content,
           parentMessageId: parent_id,
@@ -239,7 +239,7 @@ export async function handleFeishuMessage(
         await options.sendErrorMessage({
           chatId: chat_id,
           chatType: chat_type,
-          messageId: message_id,
+          message_id: message_id,
           errorText: `Failed to parse message: ${String(error)}`,
         });
         handled = true;
@@ -258,7 +258,7 @@ export async function handleFeishuMessage(
         actorId,
         chatId: chat_id,
         chatType: chat_type,
-        messageId: message_id,
+        message_id: message_id,
         ...parsedInput,
       });
       handled = handledByAuth;
@@ -284,7 +284,7 @@ async function parseIncomingMessage(params: {
   options: FeishuMessageHandlerOptions;
   chatId: string;
   chatType: string;
-  messageId: string;
+  message_id: string;
   messageType: string;
   content: string;
   parentMessageId?: string;
@@ -302,7 +302,7 @@ async function parseIncomingMessage(params: {
     await params.options.sendErrorMessage({
       chatId: params.chatId,
       chatType: params.chatType,
-      messageId: params.messageId,
+      message_id: params.message_id,
       errorText: `Unsupported Feishu message type: ${parsed.unsupportedType}`,
     });
     return {
@@ -315,7 +315,7 @@ async function parseIncomingMessage(params: {
   return {
     userMessage: parsed.text,
     incomingAttachments: await params.options.downloadIncomingAttachments({
-      messageId: params.messageId,
+      message_id: params.message_id,
       attachments: parsed.attachments,
     }),
     replyContext: await params.options.resolveReplyContext({
@@ -335,7 +335,7 @@ async function handleAuthorizedMessage(params: {
   actorId: string;
   chatId: string;
   chatType: string;
-  messageId: string;
+  message_id: string;
   userMessage: string;
   incomingAttachments: FeishuDownloadedAttachment[];
   replyContext?: InboundReplyContext;
@@ -347,7 +347,7 @@ async function handleAuthorizedMessage(params: {
     actorId,
     chatId,
     chatType,
-    messageId,
+    message_id,
     incomingAttachments,
     replyContext,
   } = params;
@@ -366,7 +366,7 @@ async function handleAuthorizedMessage(params: {
     chatId,
     chatType,
     chatTitle,
-    userId: actorId,
+    user_id: actorId,
     username: actorName,
   });
   if (!access_result.allowed) {
@@ -386,14 +386,14 @@ async function handleAuthorizedMessage(params: {
     ...(chatTitle ? { chatTitle } : {}),
   });
 
-  await options.sendInboundAckReaction({ messageId });
+  await options.sendInboundAckReaction({ message_id });
 
   await options.runInChat(threadId, async () => {
     if (userMessage.startsWith("/") && incomingAttachments.length === 0) {
       await options.handleCommand({
         chatId,
         chatType,
-        messageId,
+        message_id,
         command: userMessage,
       });
       return;
@@ -401,7 +401,7 @@ async function handleAuthorizedMessage(params: {
 
     const attachmentLines = incomingAttachments.map((attachment) => {
       const rel = path.relative(options.rootPath, attachment.path);
-      return renderChatMessageFileTag({
+      return render_chat_message_file_tag({
         type: attachment.type,
         path: rel,
         ...(attachment.desc ? { caption: attachment.desc } : {}),
@@ -421,12 +421,12 @@ async function handleAuthorizedMessage(params: {
               channel: "feishu",
               chatId,
               chatType,
-              chatKey: threadId,
-              messageId,
+              chat_key: threadId,
+              message_id,
               rootPath: options.rootPath,
               attachmentText:
                 attachmentLines.length > 0 ? attachmentLines.join("\n") : undefined,
-              bodyText: userMessage ? userMessage.trim() : undefined,
+              body_text: userMessage ? userMessage.trim() : undefined,
               attachments: incomingAttachments.map((attachment) => ({
                 channel: "feishu" as const,
                 kind: attachment.type,
@@ -447,7 +447,7 @@ async function handleAuthorizedMessage(params: {
     await options.executeAndReply({
       chatId,
       chatType,
-      messageId,
+      message_id,
       instructions,
       actorId,
       actorName,

package/src/chat/channels/feishu/FeishuPlatformClient.ts

@@ -7,7 +7,7 @@
  * - `FeishuBot` 只调用这里暴露的平台能力，不再直接持有底层 Feishu 连接细节。
  */
 
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type {
   FeishuConfig,
   FeishuDownloadedAttachment,
@@ -43,7 +43,7 @@ export interface FeishuPlatformClientOptions {
   /**
    * 当前执行上下文。
    */
-  context: AgentContext;
+  context: PluginContext;
   /**
    * 飞书渠道配置。
    */
@@ -58,9 +58,9 @@ export interface FeishuPlatformClientOptions {
  * 飞书平台 client。
  */
 export class FeishuPlatformClient {
-  private readonly context: AgentContext;
+  private readonly context: PluginContext;
   private readonly rootPath: string;
-  private readonly logger: AgentContext["logger"];
+  private readonly logger: PluginContext["logger"];
   private readonly appId: string;
   private readonly appSecret: string;
   private readonly domain?: string;
@@ -78,7 +78,7 @@ export class FeishuPlatformClient {
 
   constructor(options: FeishuPlatformClientOptions) {
     this.context = options.context;
-    this.rootPath = options.context.rootPath;
+    this.rootPath = options.context.workspace_path;
     this.logger = options.context.logger;
     this.appId = options.config.appId;
     this.appSecret = options.config.appSecret;
@@ -243,12 +243,12 @@ export class FeishuPlatformClient {
   /**
    * 给入站消息补一个轻量 ack reaction。
    */
-  async sendInboundAckReaction(params: { messageId?: string }): Promise<void> {
-    const messageId = String(params.messageId || "").trim();
-    if (!messageId || !this.client?.im?.v1?.messageReaction?.create) return;
+  async sendInboundAckReaction(params: { message_id?: string }): Promise<void> {
+    const message_id = String(params.message_id || "").trim();
+    if (!message_id || !this.client?.im?.v1?.messageReaction?.create) return;
     try {
       await this.client.im.v1.messageReaction.create({
-        path: { message_id: messageId },
+        path: { message_id: message_id },
         data: {
           reaction_type: {
             emoji_type: FEISHU_INBOUND_ACK_REACTION_TYPE,
@@ -257,7 +257,7 @@ export class FeishuPlatformClient {
       });
     } catch (error) {
       this.logger.warn("飞书入站 ack reaction 失败，继续处理消息", {
-        messageId,
+        message_id,
         reactionType: FEISHU_INBOUND_ACK_REACTION_TYPE,
         error: String(error),
       });
@@ -295,7 +295,7 @@ export class FeishuPlatformClient {
    * 下载入站附件。
    */
   async downloadIncomingAttachments(params: {
-    messageId: string;
+    message_id: string;
     attachments: FeishuIncomingAttachmentDescriptor[];
   }): Promise<FeishuDownloadedAttachment[]> {
     return downloadFeishuIncomingAttachments(this.getLookupDeps(), params);
@@ -307,10 +307,10 @@ export class FeishuPlatformClient {
   async sendAttachment(
     chatId: string,
     chatType: string,
-    messageId: string | undefined,
+    message_id: string | undefined,
     attachment: ParsedFeishuAttachmentCommand,
   ): Promise<void> {
-    return sendFeishuAttachment(this.getMessagingDeps(), chatId, chatType, messageId, attachment);
+    return sendFeishuAttachment(this.getMessagingDeps(), chatId, chatType, message_id, attachment);
   }
 
   /**
@@ -319,7 +319,7 @@ export class FeishuPlatformClient {
   async sendPlatformMessage(
     chatId: string,
     chatType: string,
-    messageId: string | undefined,
+    message_id: string | undefined,
     msgType: FeishuMessagePayloadType,
     content: Record<string, unknown> | string,
   ): Promise<void> {
@@ -327,7 +327,7 @@ export class FeishuPlatformClient {
       this.getMessagingDeps(),
       chatId,
       chatType,
-      messageId,
+      message_id,
       msgType,
       content,
     );

package/src/chat/channels/feishu/FeishuPlatformLookup.ts

@@ -447,7 +447,7 @@ export async function resolveFeishuReplyContext(
     const item = Array.isArray(payload?.data?.items) ? payload.data.items[0] : undefined;
     if (!item) return undefined;
     return buildFeishuReplyContext({
-      messageId:
+      message_id:
         typeof item.message_id === "string" ? item.message_id : parentMessageId,
       messageType: item.msg_type,
       ...(typeof item.body?.content === "string"
@@ -472,7 +472,7 @@ export async function downloadFeishuIncomingAttachments(
     /**
      * 当前消息 ID。
      */
-    messageId: string;
+    message_id: string;
     /**
      * 待下载附件列表。
      */
@@ -489,17 +489,17 @@ export async function downloadFeishuIncomingAttachments(
     try {
       const resource = await deps.client.im.v1.messageResource.get({
         path: {
-          message_id: params.messageId,
+          message_id: params.message_id,
           file_key: attachment.resourceKey,
         },
         params: {
-          type: attachment.resourceType,
+          type: attachment.resource_type,
         },
       });
 
       const fileName = buildFeishuInboundCacheFileName({
         attachment,
-        messageId: params.messageId,
+        message_id: params.message_id,
         headers: resource.headers,
       });
       const outPath = path.join(dir, fileName);
@@ -511,9 +511,9 @@ export async function downloadFeishuIncomingAttachments(
       });
     } catch (error) {
       deps.logger.warn("Failed to download incoming Feishu attachment", {
-        messageId: params.messageId,
+        message_id: params.message_id,
         resourceKey: attachment.resourceKey,
-        resourceType: attachment.resourceType,
+        resource_type: attachment.resource_type,
         error: String(error),
       });
     }

package/src/chat/channels/feishu/FeishuPlatformMessaging.ts

@@ -142,7 +142,7 @@ export async function sendFeishuPlatformMessage(
   deps: FeishuMessagingDeps,
   chatId: string,
   chatType: string,
-  messageId: string | undefined,
+  message_id: string | undefined,
   msgType: FeishuMessagePayloadType,
   content: Record<string, unknown> | string,
 ): Promise<void> {
@@ -152,10 +152,10 @@ export async function sendFeishuPlatformMessage(
   const serializedContent =
     typeof content === "string" ? content : JSON.stringify(content);
   try {
-    if (chatType !== "p2p" && messageId) {
+    if (chatType !== "p2p" && message_id) {
       await deps.client.im.v1.message.reply({
         path: {
-          message_id: messageId,
+          message_id: message_id,
         },
         data: {
           content: serializedContent,
@@ -194,25 +194,25 @@ export async function sendFeishuAttachment(
   deps: FeishuMessagingDeps,
   chatId: string,
   chatType: string,
-  messageId: string | undefined,
+  message_id: string | undefined,
   attachment: ParsedFeishuAttachmentCommand,
 ): Promise<void> {
   const localPath = await resolveAttachmentLocalPath(deps, attachment.pathOrUrl);
   if (attachment.type === "photo") {
     const imageKey = await uploadImageToFeishu(deps, localPath);
-    await sendFeishuPlatformMessage(deps, chatId, chatType, messageId, "image", {
+    await sendFeishuPlatformMessage(deps, chatId, chatType, message_id, "image", {
       image_key: imageKey,
     });
   } else {
     const fileKey = await uploadFileToFeishu(deps, localPath);
-    await sendFeishuPlatformMessage(deps, chatId, chatType, messageId, "file", {
+    await sendFeishuPlatformMessage(deps, chatId, chatType, message_id, "file", {
       file_key: fileKey,
     });
   }
 
   const caption = String(attachment.caption || "").trim();
   if (caption) {
-    await sendFeishuPlatformMessage(deps, chatId, chatType, messageId, "text", {
+    await sendFeishuPlatformMessage(deps, chatId, chatType, message_id, "text", {
       text: caption,
     });
   }

package/src/chat/channels/feishu/InboundAttachment.ts

@@ -84,7 +84,7 @@ function buildDescriptor(
   if (messageType === "image" && imageKey) {
     return {
       type: "photo",
-      resourceType: "image",
+      resource_type: "image",
       resourceKey: imageKey,
       fileName: fileName || "image",
       description: fileName || "image",
@@ -95,7 +95,7 @@ function buildDescriptor(
   if (messageType === "file" && fileKey) {
     return {
       type: "document",
-      resourceType: "file",
+      resource_type: "file",
       resourceKey: fileKey,
       ...(fileName ? { fileName } : {}),
       ...(fileName ? { description: fileName } : {}),
@@ -106,7 +106,7 @@ function buildDescriptor(
   if (messageType === "audio" && fileKey) {
     return {
       type: "audio",
-      resourceType: "audio",
+      resource_type: "audio",
       resourceKey: fileKey,
       fileName: fileName || "audio",
       description: fileName || "audio",
@@ -117,7 +117,7 @@ function buildDescriptor(
   if ((messageType === "media" || messageType === "video") && fileKey) {
     return {
       type: "video",
-      resourceType: messageType,
+      resource_type: messageType,
       resourceKey: fileKey,
       fileName: fileName || "video.mp4",
       description: fileName || "video",
@@ -239,7 +239,7 @@ export function parseFeishuInboundMessage(params: {
  */
 export function buildFeishuInboundCacheFileName(params: {
   attachment: FeishuIncomingAttachmentDescriptor;
-  messageId: string;
+  message_id: string;
   headers?: Record<string, unknown>;
 }): string {
   const headers = params.headers || {};
@@ -256,6 +256,6 @@ export function buildFeishuInboundCacheFileName(params: {
     extFromMimeType(contentType) ||
     defaultExtByAttachmentType(params.attachment);
   const baseWithoutExt = currentExt ? safeBase.slice(0, -currentExt.length) : safeBase;
-  const uniq = `${Date.now()}-${String(params.messageId || "").slice(0, 12) || "feishu"}`;
+  const uniq = `${Date.now()}-${String(params.message_id || "").slice(0, 12) || "feishu"}`;
   return `${uniq}-${baseWithoutExt}${ext}`;
 }

package/src/chat/channels/feishu/PostMessage.ts

@@ -104,7 +104,7 @@ function buildPostImageDescriptor(params: {
   const description = readString(params.description);
   return {
     type: "photo",
-    resourceType: "image",
+    resource_type: "image",
     resourceKey: params.imageKey,
     fileName: description || "image",
     description: description || "image",
@@ -117,7 +117,7 @@ function buildPostImageDescriptor(params: {
 }
 
 function buildPostFileDescriptor(params: {
-  resourceType: "file" | "audio" | "media" | "video";
+  resource_type: "file" | "audio" | "media" | "video";
   resourceKey: string;
   fileName?: string;
   duration?: number;
@@ -126,12 +126,12 @@ function buildPostFileDescriptor(params: {
   const fileName = readString(params.fileName);
   return {
     type:
-      params.resourceType === "audio"
+      params.resource_type === "audio"
         ? "audio"
-        : params.resourceType === "media" || params.resourceType === "video"
+        : params.resource_type === "media" || params.resource_type === "video"
           ? "video"
           : "document",
-    resourceType: params.resourceType,
+    resource_type: params.resource_type,
     resourceKey: params.resourceKey,
     ...(fileName ? { fileName } : {}),
     ...(fileName ? { description: fileName } : {}),
@@ -217,7 +217,7 @@ function parsePostElement(params: {
     if (fileKey) {
       params.attachments.push(
         buildPostFileDescriptor({
-          resourceType:
+          resource_type:
             tag === "audio"
               ? "audio"
               : tag === "file"
@@ -248,12 +248,12 @@ function parsePostElement(params: {
     return "---";
   }
 
-  const fallbackText =
+  const fallback_text =
     readString(element.text) ||
     readString(element.title) ||
     readString(element.href) ||
     readString(element.file_name);
-  if (fallbackText) return fallbackText;
+  if (fallback_text) return fallback_text;
 
   const fallbackImageKey = readString(element.image_key);
   if (fallbackImageKey) {

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

@@ -47,12 +47,12 @@ function describeFeishuMessage(params: {
  * 构造 Feishu reply 上下文。
  */
 export function buildFeishuReplyContext(params: {
-  messageId?: string;
+  message_id?: string;
   actorName?: string;
   messageType?: string;
   content?: string;
 }): InboundReplyContext | undefined {
-  const messageId = String(params.messageId || "").trim();
+  const message_id = String(params.message_id || "").trim();
   const actorName = String(params.actorName || "").trim();
   const text = describeFeishuMessage({
     messageType: params.messageType,
@@ -61,7 +61,7 @@ export function buildFeishuReplyContext(params: {
 
   if (!actorName && !text) return undefined;
   return {
-    ...(messageId ? { messageId } : {}),
+    ...(message_id ? { message_id } : {}),
     ...(actorName ? { actorName } : {}),
     ...(text ? { text } : {}),
   };

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

@@ -2,7 +2,7 @@ import type {
   FeishuAttachmentType,
   ParsedFeishuAttachmentCommand,
 } from "@/chat/types/FeishuAttachment.js";
-import { parseChatMessageMarkup } from "@downcity/agent";
+import { parse_chat_message_markup } from "@downcity/agent";
 
 /**
  * Feishu channel 公共工具。
@@ -43,7 +43,7 @@ export function parseFeishuAttachments(text: string): {
       }
   >;
 } {
-  const parsed = parseChatMessageMarkup(text);
+  const parsed = parse_chat_message_markup(text);
   const attachments: ParsedFeishuAttachmentCommand[] = parsed.files.map((file) => ({
     type: normalizeAttachmentType(file.type),
     pathOrUrl: String(file.path || "").trim(),
@@ -87,7 +87,7 @@ export function parseFeishuAttachments(text: string): {
   }
 
   return {
-    text: parsed.bodyText,
+    text: parsed.body_text,
     attachments,
     segments,
   };

package/src/chat/channels/qq/PROMPT.direct.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/chat/channels/qq/PROMPT.direct.ts.txt
-const TEXT_MODULE_CONTENT = "# QQ Adapter Instructions (Direct Mode)\n\n## Capability Scope\n\n- Handles message ingress and sending for the official QQ bot gateway over WebSocket.\n- Inbound messages are mapped by the chat plugin runtime to an internal `sessionId`, which is randomly assigned and persisted.\n\n## Usage Constraints\n\n- In direct mode, your assistant text output is automatically sent to the current QQ conversation.\n- QQ outbound replies depend on inbound message context such as `chatType` and `messageId`. For cross-conversation sending, use chat plugin actions instead of writing `chatKey` in direct metadata.\n- Group messages are ingested in full by default and do not require an `@` mention.\n- The adapter filters bot self-loop messages and deduplicates inbound messages to avoid \"replying to itself\" loops.\n";
+const TEXT_MODULE_CONTENT = "# QQ Adapter Instructions (Direct Mode)\n\n## Capability Scope\n\n- Handles message ingress and sending for the official QQ bot gateway over WebSocket.\n- Inbound messages are mapped by the chat plugin runtime to an internal `session_id`, which is randomly assigned and persisted.\n\n## Usage Constraints\n\n- In direct mode, your assistant text output is automatically sent to the current QQ conversation.\n- QQ outbound replies depend on inbound message context such as `chatType` and `message_id`. For cross-conversation sending, use chat plugin actions instead of writing `chat_key` in direct metadata.\n- Group messages are ingested in full by default and do not require an `@` mention.\n- The adapter filters bot self-loop messages and deduplicates inbound messages to avoid \"replying to itself\" loops.\n";
 
 export default TEXT_MODULE_CONTENT;