zalo-agent-cli 1.0.27 → 1.0.28

package/README.md

@@ -221,6 +221,7 @@ zalo-agent msg send <threadId> "Hello World" --style 0:5:bold 6:5:italic
 |---------|-------------|
 | `group list` | List all groups |
 | `group create <name> <memberIds...>` | Create group |
+| `group history <groupId> [-n count]` | Get chat history (normalized JSON) |
 | `group info <groupId>` | Group details |
 | `group members <groupId>` | List members |
 | `group add-member <groupId> <userIds...>` | Add members |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zalo-agent-cli",
-  "version": "1.0.27",
+  "version": "1.0.28",
   "description": "CLI tool for Zalo automation — multi-account, proxy support, bank transfers, QR payments",
   "type": "module",
   "bin": {

package/src/commands/group.js

@@ -46,6 +46,64 @@ export function registerGroupCommands(program) {
             }
         });
 
+    group
+        .command("history <groupId>")
+        .description("Get group chat history (recent messages)")
+        .option("-n, --count <n>", "Number of messages to fetch", "20")
+        .action(async (groupId, opts) => {
+            try {
+                const result = await getApi().getGroupChatHistory(groupId, Number(opts.count));
+                const msgs = result?.groupMsgs || [];
+
+                // Normalize messages into clean, storage-friendly JSON
+                const normalized = msgs.map((m) => {
+                    const d = m.data || m;
+                    const content = typeof d.content === "string" ? d.content : d.content;
+                    return {
+                        msgId: d.msgId,
+                        cliMsgId: d.cliMsgId,
+                        fromUid: d.uidFrom,
+                        groupId: d.idTo,
+                        msgType: d.msgType,
+                        content: typeof content === "string" ? content : content,
+                        timestamp: Number(d.ts),
+                        isoTime: new Date(Number(d.ts)).toISOString(),
+                        isSelf: m.isSelf ?? false,
+                        ...(d.mentions && { mentions: d.mentions }),
+                        ...(d.quote && {
+                            quote: {
+                                ownerId: d.quote.ownerId,
+                                msg: d.quote.msg,
+                                msgId: d.quote.globalMsgId,
+                            },
+                        }),
+                    };
+                });
+
+                const payload = {
+                    groupId,
+                    count: normalized.length,
+                    hasMore: result?.more === 1,
+                    messages: normalized,
+                };
+
+                output(payload, program.opts().json, () => {
+                    info(`${normalized.length} message(s) in group ${groupId}`);
+                    if (result?.more === 1) info("(more messages available)");
+                    console.log();
+                    for (const m of normalized) {
+                        const time = new Date(m.timestamp).toLocaleTimeString();
+                        const dir = m.isSelf ? "→" : "←";
+                        const text =
+                            typeof m.content === "string" ? m.content.slice(0, 80) : `[${m.msgType || "attachment"}]`;
+                        console.log(`  ${time} ${dir} ${m.fromUid}: ${text}`);
+                    }
+                });
+            } catch (e) {
+                error(`Get history failed: ${e.message}`);
+            }
+        });
+
     group
         .command("members <groupId>")
         .description("List group members")