zalo-agent-cli 1.0.27 → 1.0.29

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 |
@@ -327,6 +328,29 @@ zalo-agent reminder remove <reminderId> <groupId> -t 1
 | `account info` | Show active account |
 | `account export [ownerId] [-o path]` | Export credentials for transfer |
 
+#### Listener (`listen`)
+
+```bash
+# Listen for messages (default: message + friend events)
+zalo-agent listen
+
+# Filter: DM only, with webhook
+zalo-agent listen -f user -w https://your-n8n.com/webhook/zalo
+
+# Save messages locally as JSONL (one file per thread)
+zalo-agent listen --save ./zalo-logs
+
+# JSON mode for piping + save locally + webhook
+zalo-agent --json listen --save ./zalo-logs -w https://webhook.url
+
+# Auto-accept friend requests
+zalo-agent listen --auto-accept
+```
+
+**Flags:** `-e` events (message,friend,group,reaction), `-f` filter (user,group,all), `-w` webhook URL, `--save <dir>` local JSONL storage, `--no-self` exclude own messages, `--auto-accept` auto-accept friend requests
+
+**JSONL storage format:** One file per thread (`<threadId>.jsonl`), each line is a JSON object with event data + `savedAt` timestamp. Useful as workaround for chat history — Zalo API only returns ~20 recent messages.
+
 ### Multi-Account & Proxy
 
 Each Zalo account can be bound to its own dedicated proxy (1:1 mapping).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zalo-agent-cli",
-  "version": "1.0.27",
+  "version": "1.0.29",
   "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")

package/src/commands/listen.js

@@ -3,6 +3,8 @@
  * Production-ready with auto-reconnect and re-login.
  */
 
+import { appendFileSync, mkdirSync, existsSync } from "fs";
+import { resolve, join } from "path";
 import { getApi, autoLogin, clearSession } from "../core/zalo-client.js";
 import { success, error, info, warning } from "../utils/output.js";
 
@@ -41,6 +43,7 @@ export function registerListenCommand(program) {
         .option("-w, --webhook <url>", "POST each event as JSON to this URL (for n8n, Make, etc.)")
         .option("--no-self", "Exclude self-sent messages")
         .option("--auto-accept", "Auto-accept incoming friend requests")
+        .option("--save <dir>", "Save messages locally as JSONL files (one file per thread, e.g. --save ./zalo-logs)")
         .action(async (opts) => {
             const jsonMode = program.opts().json;
             const startTime = Date.now();
@@ -65,7 +68,26 @@ export function registerListenCommand(program) {
                 }).catch(() => {});
             }
 
-            /** Output event as JSON or human-readable, then post to webhook */
+            // Setup save directory if --save flag provided
+            let saveDir = null;
+            if (opts.save) {
+                saveDir = resolve(opts.save);
+                if (!existsSync(saveDir)) mkdirSync(saveDir, { recursive: true });
+                info(`Saving messages to: ${saveDir}`);
+            }
+
+            /** Append event to JSONL file (one file per threadId) */
+            function saveEvent(data) {
+                if (!saveDir || !data.threadId) return;
+                const filename = `${data.threadId}.jsonl`;
+                const filepath = join(saveDir, filename);
+                const line = JSON.stringify({ ...data, savedAt: new Date().toISOString() }) + "\n";
+                try {
+                    appendFileSync(filepath, line, "utf-8");
+                } catch {}
+            }
+
+            /** Output event as JSON or human-readable, save locally, then post to webhook */
             function emitEvent(data, humanMsg) {
                 eventCount++;
                 if (jsonMode) {
@@ -73,6 +95,7 @@ export function registerListenCommand(program) {
                 } else {
                     info(humanMsg);
                 }
+                saveEvent(data);
                 postWebhook(data);
             }
 
@@ -224,6 +247,7 @@ export function registerListenCommand(program) {
                 info("Auto-reconnect enabled.");
                 if (opts.filter !== "all") info(`Message filter: ${opts.filter}`);
                 if (opts.webhook) info(`Webhook: ${opts.webhook}`);
+                if (saveDir) info(`Save dir: ${saveDir} (JSONL per thread)`);
                 if (opts.autoAccept) info("Auto-accept friend requests: ON");
             } catch (e) {
                 error(`Listen failed: ${e.message}`);
@@ -237,6 +261,7 @@ export function registerListenCommand(program) {
                         getApi().listener.stop();
                     } catch {}
                     info(`Stopped. Uptime: ${uptime()}, events: ${eventCount}, reconnects: ${reconnectCount}`);
+                    if (saveDir) info(`Messages saved to: ${saveDir}`);
                     resolve();
                 });
             });