@max1874/feishu 0.2.25 → 0.2.26

package/package.json

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

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`);
 }