@max1874/feishu 0.2.23 → 0.2.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@max1874/feishu",
-  "version": "0.2.23",
+  "version": "0.2.25",
   "type": "module",
   "description": "OpenClaw Feishu/Lark channel plugin",
   "license": "MIT",

package/src/bot.ts

@@ -752,12 +752,30 @@ export async function handleFeishuMessage(params: {
       ...mediaPayload,
     });
 
+    // Resolve replyToMode: per-chat-type override > global > default ("all")
+    const chatTypeKey = isGroup ? "group" : "direct";
+    const replyToMode =
+      feishuCfg?.replyToModeByChatType?.[chatTypeKey] ??
+      feishuCfg?.replyToMode ??
+      "all";
+
+    // Compute effective replyToMessageId based on mode
+    let effectiveReplyToMessageId: string | undefined;
+    if (replyToMode === "all") {
+      // Always thread: reply to the triggering message
+      effectiveReplyToMessageId = ctx.messageId;
+    } else {
+      // "off": only thread if the triggering message is already in a thread
+      effectiveReplyToMessageId = ctx.rootId;
+    }
+
     const { dispatcher, replyOptions, markDispatchIdle } = createFeishuReplyDispatcher({
       cfg,
       agentId: route.agentId,
       runtime: runtime as RuntimeEnv,
       chatId: ctx.chatId,
-      replyToMessageId: ctx.messageId,
+      replyToMessageId: effectiveReplyToMessageId,
+      replyInThread: !!effectiveReplyToMessageId,
       mentionTargets: ctx.mentionTargets,
     });
 

package/src/config-schema.ts

@@ -33,6 +33,20 @@ const MarkdownConfigSchema = z
 // Message render mode: auto (default) = detect markdown, raw = plain text, card = always card
 const RenderModeSchema = z.enum(["auto", "raw", "card"]).optional();
 
+// Reply-to (threading) mode: controls whether bot replies are sent as threaded replies.
+// - "all" (default): always reply in thread (current behavior)
+// - "off": reply in main chat; only thread if the triggering message was already in a thread
+const ReplyToModeSchema = z.enum(["off", "all"]).optional();
+
+// Per-chat-type overrides for replyToMode
+const ReplyToModeByChatTypeSchema = z
+  .object({
+    direct: ReplyToModeSchema,
+    group: ReplyToModeSchema,
+  })
+  .strict()
+  .optional();
+
 const BlockStreamingCoalesceSchema = z
   .object({
     enabled: z.boolean().optional(),
@@ -90,6 +104,8 @@ export const FeishuConfigSchema = z
     mediaMaxMb: z.number().positive().optional(),
     heartbeat: ChannelHeartbeatVisibilitySchema,
     renderMode: RenderModeSchema, // raw = plain text (default), card = interactive card with markdown
+    replyToMode: ReplyToModeSchema, // "all" = always thread (default), "off" = main chat unless already in thread
+    replyToModeByChatType: ReplyToModeByChatTypeSchema, // per-chat-type overrides for replyToMode
   })
   .strict()
   .superRefine((value, ctx) => {

package/src/reply-dispatcher.ts

@@ -34,13 +34,15 @@ export type CreateFeishuReplyDispatcherParams = {
   runtime: RuntimeEnv;
   chatId: string;
   replyToMessageId?: string;
+  /** When true, reply only appears in thread (not in main chat timeline) */
+  replyInThread?: boolean;
   /** Mention targets, will be auto-included in replies */
   mentionTargets?: MentionTarget[];
 };
 
 export function createFeishuReplyDispatcher(params: CreateFeishuReplyDispatcherParams) {
   const core = getFeishuRuntime();
-  const { cfg, agentId, chatId, replyToMessageId, mentionTargets } = params;
+  const { cfg, agentId, chatId, replyToMessageId, replyInThread, mentionTargets } = params;
 
   const prefixContext = createReplyPrefixContext({
     cfg,
@@ -127,6 +129,7 @@ export function createFeishuReplyDispatcher(params: CreateFeishuReplyDispatcherP
               to: chatId,
               text: chunk,
               replyToMessageId,
+              replyInThread,
               mentions: isFirstChunk ? mentionTargets : undefined,
             });
             isFirstChunk = false;
@@ -142,6 +145,7 @@ export function createFeishuReplyDispatcher(params: CreateFeishuReplyDispatcherP
               to: chatId,
               text: chunk,
               replyToMessageId,
+              replyInThread,
               mentions: isFirstChunk ? mentionTargets : undefined,
             });
             isFirstChunk = false;

package/src/send.ts

@@ -201,12 +201,14 @@ export type SendFeishuMessageParams = {
   to: string;
   text: string;
   replyToMessageId?: string;
+  /** When true, reply only appears in thread (not in main chat timeline) */
+  replyInThread?: boolean;
   /** Mention target users */
   mentions?: MentionTarget[];
 };
 
 export async function sendMessageFeishu(params: SendFeishuMessageParams): Promise<FeishuSendResult> {
-  const { cfg, to, text, replyToMessageId, mentions } = params;
+  const { cfg, to, text, replyToMessageId, replyInThread, mentions } = params;
   const feishuCfg = cfg.channels?.feishu as FeishuConfig | undefined;
   if (!feishuCfg) {
     throw new Error("Feishu channel not configured");
@@ -239,6 +241,7 @@ export async function sendMessageFeishu(params: SendFeishuMessageParams): Promis
       data: {
         content,
         msg_type: "text",
+        ...(replyInThread ? { reply_in_thread: true } : {}),
       },
     });
 
@@ -276,10 +279,11 @@ export type SendFeishuCardParams = {
   to: string;
   card: Record<string, unknown>;
   replyToMessageId?: string;
+  replyInThread?: boolean;
 };
 
 export async function sendCardFeishu(params: SendFeishuCardParams): Promise<FeishuSendResult> {
-  const { cfg, to, card, replyToMessageId } = params;
+  const { cfg, to, card, replyToMessageId, replyInThread } = params;
   const feishuCfg = cfg.channels?.feishu as FeishuConfig | undefined;
   if (!feishuCfg) {
     throw new Error("Feishu channel not configured");
@@ -300,6 +304,7 @@ export async function sendCardFeishu(params: SendFeishuCardParams): Promise<Feis
       data: {
         content,
         msg_type: "interactive",
+        ...(replyInThread ? { reply_in_thread: true } : {}),
       },
     });
 
@@ -383,17 +388,18 @@ export async function sendMarkdownCardFeishu(params: {
   to: string;
   text: string;
   replyToMessageId?: string;
+  replyInThread?: boolean;
   /** Mention target users */
   mentions?: MentionTarget[];
 }): Promise<FeishuSendResult> {
-  const { cfg, to, text, replyToMessageId, mentions } = params;
+  const { cfg, to, text, replyToMessageId, replyInThread, mentions } = params;
   // Build message content (with @mention support)
   let cardText = text;
   if (mentions && mentions.length > 0) {
     cardText = buildMentionedCardContent(mentions, text);
   }
   const card = buildMarkdownCard(cardText);
-  return sendCardFeishu({ cfg, to, card, replyToMessageId });
+  return sendCardFeishu({ cfg, to, card, replyToMessageId, replyInThread });
 }
 
 /**