@max1874/feishu 0.2.24 → 0.2.26

package/package.json

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

package/src/bot.ts

@@ -775,6 +775,7 @@ export async function handleFeishuMessage(params: {
       runtime: runtime as RuntimeEnv,
       chatId: ctx.chatId,
       replyToMessageId: effectiveReplyToMessageId,
+      replyInThread: !!effectiveReplyToMessageId,
       mentionTargets: ctx.mentionTargets,
     });
 

package/src/channel.ts

@@ -55,6 +55,7 @@ export const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount> = {
     messageToolHints: () => [
       "- Feishu targeting: omit `target` to reply to the current conversation (auto-inferred). Explicit targets: `user:open_id` or `chat:chat_id`.",
       "- Feishu supports interactive cards for rich messages.",
+      "- Use feishu_chat_messages to read message history. Omit chat_id to read from the current conversation.",
     ],
   },
   groups: {

package/src/docx.ts

@@ -1247,5 +1247,113 @@ export function registerFeishuDocTools(api: OpenClawPluginApi) {
     { name: "feishu_app_scopes" },
   );
 
-  api.logger.info?.(`feishu_doc: Registered 14 document/wiki tools`);
+  // Tool 15: feishu_chat_messages
+  const ChatMessagesSchema = Type.Object({
+    chat_id: Type.Optional(
+      Type.String({
+        description: "Chat ID (oc_xxx). Omit to use the current conversation.",
+      }),
+    ),
+    start_time: Type.Optional(
+      Type.String({ description: "Start time, Unix timestamp in seconds" }),
+    ),
+    end_time: Type.Optional(
+      Type.String({ description: "End time, Unix timestamp in seconds" }),
+    ),
+    sort_type: Type.Optional(
+      Type.Union([Type.Literal("ByCreateTimeAsc"), Type.Literal("ByCreateTimeDesc")], {
+        description: "Sort order (default: ByCreateTimeDesc)",
+      }),
+    ),
+    page_size: Type.Optional(
+      Type.Number({ description: "Page size, 1-50 (default 20)" }),
+    ),
+    page_token: Type.Optional(
+      Type.String({ description: "Pagination token from previous response" }),
+    ),
+  });
+
+  api.registerTool(
+    {
+      name: "feishu_chat_messages",
+      label: "Feishu Chat Messages",
+      description:
+        "Read message history from a Feishu chat (group or DM). " +
+        "Omit chat_id to read from the current conversation. " +
+        "Returns messages with sender info, content, and timestamps. " +
+        "Requires im:message scope; bot must be a member of the chat.",
+      parameters: ChatMessagesSchema,
+      async execute(_toolCallId, params) {
+        const {
+          chat_id,
+          start_time,
+          end_time,
+          sort_type,
+          page_size,
+          page_token,
+        } = params as {
+          chat_id?: string;
+          start_time?: string;
+          end_time?: string;
+          sort_type?: "ByCreateTimeAsc" | "ByCreateTimeDesc";
+          page_size?: number;
+          page_token?: string;
+        };
+        try {
+          const container_id = chat_id || getConversationContext()?.chatId;
+          if (!container_id) {
+            return json({
+              error:
+                "No chat_id provided and no current conversation context available.",
+            });
+          }
+
+          const client = getClient();
+          const res = await client.im.message.list({
+            params: {
+              container_id_type: "chat",
+              container_id,
+              ...(start_time && { start_time }),
+              ...(end_time && { end_time }),
+              ...(sort_type && { sort_type }),
+              ...(page_size && { page_size }),
+              ...(page_token && { page_token }),
+            },
+          });
+
+          if (res.code !== 0) throw new Error(res.msg);
+
+          const messages = (res.data?.items ?? []).map((m) => {
+            let content: unknown = m.body?.content;
+            if (typeof content === "string") {
+              try {
+                content = JSON.parse(content);
+              } catch {
+                // keep raw string
+              }
+            }
+            return {
+              message_id: m.message_id,
+              msg_type: m.msg_type,
+              sender: m.sender,
+              content,
+              create_time: m.create_time,
+              deleted: m.deleted,
+            };
+          });
+
+          return json({
+            messages,
+            has_more: res.data?.has_more ?? false,
+            page_token: res.data?.page_token,
+          });
+        } catch (err) {
+          return json({ error: err instanceof Error ? err.message : String(err) });
+        }
+      },
+    },
+    { name: "feishu_chat_messages" },
+  );
+
+  api.logger.info?.(`feishu_doc: Registered 15 document/wiki/messaging tools`);
 }

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 });
 }
 
 /**