@ardennguyen/zalo-agent-cli 2.2.2 → 2.5.1

package/README.md

@@ -50,7 +50,7 @@ Xây dựng trên [zca-js](https://github.com/RFS-ADRENO/zca-js).
 > zalo-agent mcp start --account <ID>                   # Ghim tài khoản (chạy nhiều tài khoản live cùng lúc)
 > zalo-agent mcp start --http 3847 --auth your-secret   # HTTP (VPS)
 > ```
-> 21 tools: `zalo_get_messages` · `zalo_send_message` · `zalo_list_threads` · `zalo_search_threads` · `zalo_mark_read` · `zalo_get_history` · `zalo_view_media` · `zalo_react` · `zalo_undo` · `zalo_get_group_members` · `zalo_list_conversations` · `zalo_coverage` · `zalo_sync` · `zalo_sync_status` · `zalo_search_messages` · `zalo_lookup_user` · `zalo_forward_message` · `zalo_delete_message` · `zalo_reminder` · `zalo_note` · `zalo_poll`
+> 23 tools: `zalo_get_messages` · `zalo_send_message` · `zalo_list_threads` · `zalo_search_threads` · `zalo_mark_read` · `zalo_get_history` · `zalo_view_media` · `zalo_react` · `zalo_undo` · `zalo_get_group_members` · `zalo_list_conversations` · `zalo_coverage` · `zalo_sync` · `zalo_sync_status` · `zalo_search_messages` · `zalo_lookup_user` · `zalo_forward_message` · `zalo_delete_message` · `zalo_reminder` · `zalo_note` · `zalo_poll` · `zalo_wait_for_message` · `zalo_label`
 
 [Sync qua MCP](docs/mcp-sync.vi.md) · [Ghim đa tài khoản live](docs/account-pinning.vi.md).
 > Auto-reconnect · thread filter · noise reduction · tự tải media · thông báo qua nhóm Zalo · chạy song song nhiều tài khoản (`--account <ID>`)
@@ -124,7 +124,7 @@ Tất cả lệnh hỗ trợ `--json`. Tài liệu đầy đủ: **[Wiki](https:
 | `label` | 2 | Nhãn hội thoại | [Nhãn](https://github.com/ardennguyen/zalo-agent-cli/wiki/Nh%C3%A3n) |
 | `catalog` | 9 | zBusiness — danh mục sản phẩm | [zBusiness](https://github.com/ardennguyen/zalo-agent-cli/wiki/zBusiness) |
 | `listen` | 1 | Lắng nghe real-time, webhook, JSONL, ghi vào cache cục bộ | [Lắng nghe](https://github.com/ardennguyen/zalo-agent-cli/wiki/L%E1%BA%AFng-Nghe) |
-| `mcp` | 1 | MCP server (stdio/HTTP) — 21 tools cho AI agent | [MCP Server](https://github.com/ardennguyen/zalo-agent-cli/wiki/MCP-Server-(VN)) |
+| `mcp` | 1 | MCP server (stdio/HTTP/HTTPS) — 23 tools cho AI agent | [MCP Server](https://github.com/ardennguyen/zalo-agent-cli/wiki/MCP-Server-(VN)) |
 | **`oa`** | **32** | **Zalo Official Account API v3.0 — OAuth, tin nhắn, follower, tag, bài viết, cửa hàng, webhook** | **[Official Account](https://github.com/ardennguyen/zalo-agent-cli/wiki/Official-Account-(VN))** |
 
 Xem thêm: [Đa tài khoản & Proxy](https://github.com/ardennguyen/zalo-agent-cli/wiki/%C4%90a-T%C3%A0i-Kho%E1%BA%A3n-&-Proxy) · [Cài đặt VPS](https://github.com/ardennguyen/zalo-agent-cli/wiki/C%C3%A0i-%C4%90%E1%BA%B7t-VPS) · [Thẻ chuyển khoản & QR](https://github.com/ardennguyen/zalo-agent-cli/wiki/Th%E1%BA%BB-Chuy%E1%BB%83n-Kho%E1%BA%A3n-&-QR) · [Bộ nhớ đệm & Đồng bộ](https://github.com/ardennguyen/zalo-agent-cli/wiki/B%E1%BB%99-Nh%E1%BB%9B-%C4%90%E1%BB%87m-&-%C4%90%E1%BB%93ng-B%E1%BB%99) · [Bảo mật](https://github.com/ardennguyen/zalo-agent-cli/wiki/B%E1%BA%A3o-M%E1%BA%ADt)
@@ -137,7 +137,7 @@ Xem thêm: [Đa tài khoản & Proxy](https://github.com/ardennguyen/zalo-agent-
 - Đa tài khoản với proxy riêng biệt (1:1), device fingerprint riêng cho từng tài khoản; chạy **nhiều tài khoản live đồng thời** (mỗi tài khoản một tiến trình `mcp start` hoặc `listen` kèm `--account <ID>`, và truyền `--account <ID>` / `ZALO_ACCOUNT` trên mọi lệnh CLI mà không ghi đè `accounts.json`)
 - **190 lệnh** phủ hết tính năng Zalo cá nhân
 - **Zalo Official Account (OA) API v3.0** — OAuth login, gửi tin nhắn, follower, tag, bài viết, cửa hàng, webhook listener, multi-OA
-- **MCP server** (stdio + HTTP) — 21 tools cho Claude Code và các MCP client: đọc, gửi (văn bản, link preview, danh thiếp, vào My Documents, đánh dấu Quan trọng/Khẩn cấp), tìm kiếm tin nhắn trong cache, tra cứu người dùng, thả cảm xúc, thu hồi, chuyển tiếp, xóa tin, nhắc hẹn, ghi chú/ghim tin, bình chọn, xem thành viên nhóm, liệt kê hội thoại gần đây và kiểm tra độ đầy đủ của cache
+- **MCP server** (stdio + HTTP/HTTPS + OAuth 2.0) — 23 tools cho Claude Code, Gemini và các MCP client: đọc, chờ tin nhắn đến (`zalo_wait_for_message`), gửi (văn bản, link preview, danh thiếp, vào My Documents, đánh dấu Quan trọng/Khẩn cấp), tìm kiếm tin nhắn trong cache, tra cứu người dùng, gắn/gỡ nhãn hội thoại (`zalo_label`), thả cảm xúc, thu hồi, chuyển tiếp, xóa tin, nhắc hẹn, ghi chú/ghim tin, bình chọn, xem thành viên nhóm, liệt kê hội thoại gần đây và kiểm tra độ đầy đủ của cache
 - **Bộ nhớ đệm cục bộ (SQLite)** — `listen` ghi mọi tin nhắn vào `zalo.db`, `msg history` đọc từ cache, `sync` (hoặc `sync-mobile`) khôi phục toàn bộ lịch sử từ điện thoại vào `zalo.db` (giải mã transfer-sync-v2; xác nhận một lần trên điện thoại), mặc định lấy **toàn bộ** lịch sử (không còn mốc chặn 2024-01-01); thêm `--days <n>` hoặc `--from <YYYY-MM-DD>` nếu chỉ cần một khoảng. Dọn dẹp: `sync-media --prune <days|all>` giải phóng dung lượng nhưng giữ nguyên nội dung tin nhắn, `--prune-orphans` nhắm vào hội thoại tài khoản không còn, và `conv forget` xoá hẳn bản sao cục bộ của một hội thoại — không cái nào gửi gì tới Zalo. Luồng đồng bộ chỉ mang **liên kết** media chứ không mang file, nên sau khi lưu tin nhắn, `sync-mobile` **tự động tải media về** (thêm `--messages-only` nếu chỉ muốn tin nhắn); `sync-media` chạy lại/tiếp tục bước tải này, không cần xác nhận trên điện thoại. Ghi chú, tin ghim, bình chọn và nhắc hẹn nằm ngoài luồng tin nhắn — dùng `sync-boards`
 - Tự động tải media (ảnh/audio/video) — một downloader duy nhất cho `listen`, `msg history`, `mcp start` và các lệnh sync, lưu vào `~/.zalo-agent-cli/accounts/<id>/media/<threadId>/` (hoặc tách riêng credentials, database `zalo.db`, media và OA sang các ổ đĩa/mount khác nhau qua `--credentials-dir`, `--data-dir`, `--media-dir`, `--oa-dir` / biến môi trường `ZALO_*_DIR` trong `~/.zalo-agent-cli/.env`; nếu dùng kèm `zalo-mcp`, chỉ nên giữ cấu hình PORT trong `zalo-mcp/.env` và đặt toàn bộ đường dẫn lưu trữ vào `<CONFIG_DIR>/.env`)
 - Thẻ chuyển khoản (55+ ngân hàng VN) & QR VietQR
@@ -215,7 +215,7 @@ CLI tool for Zalo automation — multi-account, proxy support, bank transfers, Q
 > zalo-agent mcp start --account <ID>                   # Pin account (run multiple live accounts at once)
 > zalo-agent mcp start --http 3847 --auth your-secret   # HTTP (VPS)
 > ```
-> 21 tools: `zalo_get_messages` · `zalo_send_message` · `zalo_list_threads` · `zalo_search_threads` · `zalo_mark_read` · `zalo_get_history` · `zalo_view_media` · `zalo_react` · `zalo_undo` · `zalo_get_group_members` · `zalo_list_conversations` · `zalo_coverage` · `zalo_sync` · `zalo_sync_status` · `zalo_search_messages` · `zalo_lookup_user` · `zalo_forward_message` · `zalo_delete_message` · `zalo_reminder` · `zalo_note` · `zalo_poll`
+> 23 tools: `zalo_get_messages` · `zalo_send_message` · `zalo_list_threads` · `zalo_search_threads` · `zalo_mark_read` · `zalo_get_history` · `zalo_view_media` · `zalo_react` · `zalo_undo` · `zalo_get_group_members` · `zalo_list_conversations` · `zalo_coverage` · `zalo_sync` · `zalo_sync_status` · `zalo_search_messages` · `zalo_lookup_user` · `zalo_forward_message` · `zalo_delete_message` · `zalo_reminder` · `zalo_note` · `zalo_poll` · `zalo_wait_for_message` · `zalo_label`
 
 [MCP sync](docs/mcp-sync.md) · [Multi-account pinning](docs/account-pinning.md).
 > Auto-reconnect · thread filter · noise reduction · media auto-download · Zalo-group notifications · concurrent multi-account (`--account <ID>`)
@@ -255,7 +255,7 @@ Full docs: **[Wiki](https://github.com/ardennguyen/zalo-agent-cli/wiki)** · [Fu
 | `label` | 2 | Conversation labels | [Labels](https://github.com/ardennguyen/zalo-agent-cli/wiki/Labels) |
 | `catalog` | 9 | zBusiness catalogs & products | [Catalog](https://github.com/ardennguyen/zalo-agent-cli/wiki/Catalog) |
 | `listen` | 1 | Real-time listener, webhook, JSONL, local cache writes | [Listener](https://github.com/ardennguyen/zalo-agent-cli/wiki/Listener) |
-| `mcp` | 1 | MCP server (stdio/HTTP) — 21 tools for AI agents | [MCP Server](https://github.com/ardennguyen/zalo-agent-cli/wiki/MCP-Server) |
+| `mcp` | 1 | MCP server (stdio/HTTP/HTTPS) — 23 tools for AI agents | [MCP Server](https://github.com/ardennguyen/zalo-agent-cli/wiki/MCP-Server) |
 | **`oa`** | **32** | **Zalo Official Account API v3.0 — OAuth, messaging, followers, tags, articles, store, webhook** | **[Official Account](https://github.com/ardennguyen/zalo-agent-cli/wiki/Official-Account)** |
 
 See also: [Multi-Account & Proxy](https://github.com/ardennguyen/zalo-agent-cli/wiki/Multi-Account-&-Proxy) · [VPS Setup](https://github.com/ardennguyen/zalo-agent-cli/wiki/VPS-Setup) · [Bank Card & QR Payments](https://github.com/ardennguyen/zalo-agent-cli/wiki/Bank-Card-&-QR-Payments) · [Local Cache & Sync](https://github.com/ardennguyen/zalo-agent-cli/wiki/Local-Cache-&-Sync) · [Security](https://github.com/ardennguyen/zalo-agent-cli/wiki/Security)
@@ -266,7 +266,7 @@ See also: [Multi-Account & Proxy](https://github.com/ardennguyen/zalo-agent-cli/
 - Multi-account with a dedicated proxy (1:1) and a per-account device fingerprint; run **multiple live accounts simultaneously** (one `mcp start` or `listen` process per account with `--account <ID>`, plus `--account <ID>` / `ZALO_ACCOUNT` on any CLI command without mutating `accounts.json`)
 - **190 commands** covering the personal-account Zalo surface
 - **Zalo Official Account (OA) API v3.0** — OAuth login, messaging, followers, tags, articles, store, webhook listener, multi-OA
-- **MCP server** (stdio + HTTP) — 21 tools for Claude Code and other MCP clients: read, send (text, link previews, contact cards, to My Documents too, marked Important/Urgent), search cached messages, look up users, react, recall, forward, delete, reminders, group notes/pins, group polls, list a group's members, list recent conversations, and check how complete the cache is
+- **MCP server** (stdio + HTTP/HTTPS + OAuth 2.0) — 23 tools for Claude Code, Gemini and other MCP clients: read, wait for incoming messages (`zalo_wait_for_message`), send (text, link previews, contact cards, to My Documents too, marked Important/Urgent), search cached messages, look up users, manage conversation labels (`zalo_label`), react, recall, forward, delete, reminders, group notes/pins, group polls, list a group's members, list recent conversations, and check how complete the cache is
 - **Local SQLite cache** — `listen` writes every message to `zalo.db`, `msg history` reads from it, and `sync` (or `sync-mobile`) restores full history from the phone into `zalo.db` (transfer-sync-v2 decrypt; one confirmation on the phone), defaulting to **all** history (the old 2024-01-01 floor is gone), with `--days <n>` or `--from <YYYY-MM-DD>` to narrow it. Housekeeping: `sync-media --prune <days|all>` reclaims disk while keeping message text, `--prune-orphans` targets conversations the account no longer has, and `conv forget` removes a conversation's local copy entirely — none of which contact Zalo. The sync stream carries media **links**, not files, so a `sync-mobile` run **downloads its attachments automatically** once the messages are stored (`--messages-only` skips it); `sync-media` re-runs or resumes that fetch on its own, with no phone confirmation. Notes, pinned messages, polls and reminders live outside the message stream — `sync-boards` fetches those
 - Automatic media download — one downloader shared by `listen`, `msg history`, `mcp start` and the sync commands, saving to `~/.zalo-agent-cli/accounts/<id>/media/<threadId>/` (or separate credentials, `zalo.db`, media, and OA credentials onto independent volumes/mounts via `--credentials-dir`, `--data-dir`, `--media-dir`, `--oa-dir` / `ZALO_*_DIR` in `~/.zalo-agent-cli/.env`; when using `zalo-mcp`, keep `zalo-mcp/.env` for PORT settings only and place all storage/engine settings in `<CONFIG_DIR>/.env`)
 - Bank cards (55+ VN banks) and VietQR payment images

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ardennguyen/zalo-agent-cli",
-    "version": "2.2.2",
+    "version": "2.5.1",
     "description": "CLI tool for Zalo automation — multi-account, proxy, bank transfers, QR payments, Official Account API v3.0",
     "type": "module",
     "bin": {

package/src/commands/conv.js

@@ -13,6 +13,7 @@ import { recentConversations } from "../core/recent-conversations.js";
 import { describeReadState, readStateLabel } from "../core/read-state.js";
 import { pruneDownloadedMedia } from "../core/sync-v2/media.js";
 import { markConversationRead, zaloPost } from "../core/receipts.js";
+import { readUserAliases, currentUserName } from "../core/current-user-names.js";
 
 /**
  * Find the newest message in a thread and return the anchor triple
@@ -298,10 +299,16 @@ export function registerConvCommands(program, deps = {}) {
                         .filter((f) => f.lastActionTime > 0)
                         .sort((a, b) => b.lastActionTime - a.lastActionTime)
                         .slice(0, limit);
+                    const aliases = sorted.length > 0 ? await readUserAliases(api) : new Map();
                     for (const f of sorted) {
+                        const resolved = currentUserName(f.userId, f, aliases);
                         conversations.push({
                             threadId: f.userId,
-                            name: f.displayName || f.zaloName || "?",
+                            name:
+                                (resolved.source !== "uid" ? resolved.name : null) ||
+                                f.displayName ||
+                                f.zaloName ||
+                                "?",
                             type: "User",
                             typeFlag: 0,
                             // lastActionTime is epoch MILLISECONDS (13 digits). The old x1000

package/src/commands/listen.js

@@ -3,14 +3,22 @@
  * Production-ready with auto-reconnect and re-login.
  */
 
+import { createHmac } from "crypto";
 import { appendFileSync, mkdirSync, existsSync } from "fs";
 import { resolve, join } from "path";
 import { getApi, clearSession } from "../core/zalo-client.js";
-import { success, error, info, warning } from "../utils/output.js";
+import { success, error, info, warning, output } from "../utils/output.js";
 import { parseAccountId, selectDaemonAccount, loginDaemonAccount } from "../core/daemon-account.js";
+import { updateAccountName } from "../core/accounts.js";
 import { getAccountDir } from "../core/credentials.js";
 import { acquireLock, releaseLock } from "../core/lock.js";
-import { createStageLock, startDaemonChannel } from "../core/daemon-channel.js";
+import {
+    createStageLock,
+    startDaemonChannel,
+    getDaemonStatus,
+    stopDaemon,
+    spawnDaemonProcess,
+} from "../core/daemon-channel.js";
 import { createSyncRunners } from "../core/daemon-sync.js";
 import { createSocketTap } from "../core/socket-tap.js";
 import { createSelfHeal } from "../core/self-heal.js";
@@ -18,6 +26,7 @@ import { createReadStateSync, readStateEvent } from "../core/read-state.js";
 import { initDb, getPendingSyncGaps } from "../core/db.js";
 import {
     storeLiveMessage,
+    refreshLiveMessageIdentities,
     storeLiveDelete,
     storeLiveReaction,
     storeLiveUndo,
@@ -31,6 +40,7 @@ import { downloadSyncedMedia } from "../core/sync-v2/media.js";
 import { SyncManager } from "../core/sync.js";
 import { describeGap } from "../core/sync-v2/gap-advice.js";
 import { createDeliveredReceipts } from "../core/receipts.js";
+import { envForAccount } from "../mcp/mcp-config.js";
 
 /** Thread types matching zca-js ThreadType enum */
 const THREAD_USER = 0;
@@ -65,8 +75,8 @@ export function registerListenCommand(program) {
         )
         .option(
             "-e, --events <types>",
-            "Comma-separated event types: message,friend,group,reaction,read (default: message,friend)",
-            "message,friend",
+            "Comma-separated event types: message,friend,group,reaction,read (default: message,friend,group,reaction,read)",
+            "message,friend,group,reaction,read",
         )
         .option("-f, --filter <type>", "Message filter: user (DM only), group (groups only), all", "all")
         .option("-w, --webhook <url>", "POST each event as JSON to this URL (for n8n, Make, etc.)")
@@ -81,7 +91,11 @@ export function registerListenCommand(program) {
             "--no-self-heal",
             "Do not pull what a dropped socket missed from Zalo's offline queue on reconnect (the default does, as Zalo Web does, on this socket and with no phone tap)",
         )
+        .option("-d, --daemon", "Run in the background (logs to <accountDir>/daemon.log)")
+        .option("--stop", "Stop the running background daemon for this account")
+        .option("--status", "Show background daemon status for this account")
         .action(async (opts) => {
+            const jsonMode = program.opts().json;
             let activeAcc;
             try {
                 const requestedAccount =
@@ -92,6 +106,68 @@ export function registerListenCommand(program) {
                 process.exit(1);
             }
             const accountDir = getAccountDir(activeAcc.ownId);
+
+            if (opts.status) {
+                const status = getDaemonStatus(accountDir);
+                output({ accountId: activeAcc.ownId, ...status }, jsonMode, () => {
+                    if (status.running) {
+                        success(
+                            `Daemon running for account ${activeAcc.ownId} (PID ${status.pid}${status.channelPort ? `, channel 127.0.0.1:${status.channelPort}` : ""})`,
+                        );
+                        info(`Log file: ${status.logPath}`);
+                    } else {
+                        info(`No daemon running for account ${activeAcc.ownId}`);
+                        info(`Log file: ${status.logPath}`);
+                    }
+                });
+                return;
+            }
+
+            if (opts.stop) {
+                const res = await stopDaemon(accountDir);
+                output({ accountId: activeAcc.ownId, ...res }, jsonMode, () => {
+                    if (res.stopped) {
+                        success(
+                            `Stopped daemon for account ${activeAcc.ownId} (PID ${res.pid}${res.graceful ? "" : ", forced"})`,
+                        );
+                    } else {
+                        info(`No daemon running for account ${activeAcc.ownId}`);
+                    }
+                });
+                return;
+            }
+
+            if (opts.daemon && !process.env.ZALO_DAEMON_CHILD) {
+                const spawned = await spawnDaemonProcess({ accountDir, args: process.argv.slice(1) });
+                if (!spawned.ok) {
+                    if (spawned.alreadyRunning) {
+                        error(
+                            `Another listen daemon is already running for account ${activeAcc.ownId} (PID ${spawned.pid}).`,
+                        );
+                        info("Stop it first with: zalo-agent listen --stop");
+                    } else {
+                        error(`Failed to start background listener: ${spawned.error}`);
+                        info(`Log file: ${spawned.logPath}`);
+                    }
+                    process.exit(1);
+                }
+                output(
+                    {
+                        accountId: activeAcc.ownId,
+                        pid: spawned.pid,
+                        channelPort: spawned.channelPort,
+                        logPath: spawned.logPath,
+                    },
+                    jsonMode,
+                    () => {
+                        success(`Listener started in background for account ${activeAcc.ownId} (PID ${spawned.pid})`);
+                        info(`Log file: ${spawned.logPath}`);
+                        info("Stop with: zalo-agent listen --stop");
+                    },
+                );
+                return;
+            }
+
             if (!acquireLock(accountDir)) {
                 error(`Another listen daemon is already running for account ${activeAcc.ownId}.`);
                 process.exit(1);
@@ -284,7 +360,6 @@ export function registerListenCommand(program) {
             }
             const heartbeatTimer = setInterval(heartbeat, HEARTBEAT_MS);
 
-            const jsonMode = program.opts().json;
             const startTime = Date.now();
             let reconnectCount = 0;
             let eventCount = 0;
@@ -308,13 +383,24 @@ export function registerListenCommand(program) {
                 return h > 0 ? `${h}h${m}m` : `${m}m${s % 60}s`;
             }
 
+            const webhookUrl = opts.webhook?.trim() || envForAccount("ZALO_WEBHOOK_URL", activeAcc.ownId) || null;
+            const webhookSecret = envForAccount("ZALO_WEBHOOK_SECRET", activeAcc.ownId) || null;
+
             /** Fire-and-forget webhook POST — never blocks event processing */
             function postWebhook(data) {
-                if (!opts.webhook) return;
-                fetch(opts.webhook, {
+                if (!webhookUrl) return;
+                const payload = { accountId: activeAcc.ownId, ...data };
+                const body = JSON.stringify(payload);
+                const headers = { "Content-Type": "application/json" };
+                if (webhookSecret) {
+                    headers["Authorization"] = `Bearer ${webhookSecret}`;
+                    headers["X-Zalo-Signature"] =
+                        `sha256=${createHmac("sha256", webhookSecret).update(body).digest("hex")}`;
+                }
+                fetch(webhookUrl, {
                     method: "POST",
-                    headers: { "Content-Type": "application/json" },
-                    body: JSON.stringify(data),
+                    headers,
+                    body,
                     signal: AbortSignal.timeout(5000),
                 }).catch((e) => {
                     console.error(`[listen] Webhook failed: ${e.message}`);
@@ -504,6 +590,10 @@ export function registerListenCommand(program) {
                             console.error(`[listen] message not stored: ${stored.reason}`);
                             return;
                         }
+                        refreshLiveMessageIdentities(api, msg, {
+                            onSelfName: (name) => updateAccountName(activeAcc.ownId, name),
+                            log: (line) => console.error(`[listen] ${line}`),
+                        }).catch((err) => console.error(`[listen] identity refresh failed: ${err.message}`));
                         // Fetch through the SAME downloader the mobile sync
                         // uses: it brings the request deadline, the
                         // expiry-vs-throttling classification and the shared
@@ -761,7 +851,7 @@ export function registerListenCommand(program) {
                 info(`Events: ${opts.events}`);
                 info("Auto-reconnect enabled.");
                 if (opts.filter !== "all") info(`Message filter: ${opts.filter}`);
-                if (opts.webhook) info(`Webhook: ${opts.webhook}`);
+                if (webhookUrl) info(`Webhook: ${webhookUrl}${webhookSecret ? " (signed)" : ""}`);
                 if (saveDir) info(`Save dir: ${saveDir} (JSONL per thread)`);
                 if (opts.autoAccept) info("Auto-accept friend requests: ON");
                 info(
@@ -794,14 +884,53 @@ export function registerListenCommand(program) {
             // rebuilds one on a duplicate-session close, and a stage bound to
             // the old object would tap a socket zca-js has already nulled.
             let channel = null;
+            const shutdown = () => {
+                // First, before anything can emit a close event.
+                stopping = true;
+                channel?.stop();
+                deliveredReceipts.stop();
+                try {
+                    getApi().listener.stop();
+                } catch (e) {
+                    console.error(`[listen] Stop failed: ${e.message}`);
+                }
+                clearInterval(heartbeatTimer);
+                // Stamp "last known connected" at the moment we stop, so a
+                // deliberate close (or the process simply exiting) gives
+                // the NEXT launch an accurate window to backfill from,
+                // rather than treating this whole downtime as unknown.
+                try {
+                    syncManager.markConnected();
+                } catch (e) {
+                    console.error(`[listen] Failed to stamp shutdown state: ${e.message}`);
+                }
+                releaseLock(accountDir);
+                info(`Stopped. Uptime: ${uptime()}, events: ${eventCount}, reconnects: ${reconnectCount}`);
+                const receipts = deliveredReceipts.stats();
+                if (receipts.calls) {
+                    info(`Delivered receipts: ${receipts.sent} acknowledged, ${receipts.failed} failed`);
+                }
+                if (saveDir) info(`Messages saved to: ${saveDir}`);
+                // Resolving the keep-alive promise is not enough: an async
+                // `closed` handler already in flight resumes after the action
+                // function has returned and keeps the process alive. mcp.js
+                // already exits explicitly here for the same reason.
+                process.exit(0);
+            };
+
             try {
                 channel = await startDaemonChannel({
                     getApi,
                     accountDir,
                     onLog: (m) => info(m),
-                    runners: createSyncRunners({ getApi, accountName: activeAcc.ownId }),
+                    runners: createSyncRunners({
+                        getApi,
+                        accountName: activeAcc.ownId,
+                        onSelfName: (name) => updateAccountName(activeAcc.ownId, name),
+                    }),
                     // The self-heal's lock: a stage and a catch-up never share the socket.
                     lock: stageLock,
+                    onStop: shutdown,
                 });
                 info(`Sync & upload channel ready on 127.0.0.1:${channel.port} — this socket is reused for both.`);
                 info("`zalo-agent sync` will run its socket stages here; it still needs your phone tap.");
@@ -810,42 +939,15 @@ export function registerListenCommand(program) {
                 warning("Attachment sends will open their own session, and `zalo-agent sync` will refuse to run.");
             }
 
-            // Keep alive until Ctrl+C
-            await new Promise((resolve) => {
+            // Keep alive until Ctrl+C or `listen --stop`
+            await new Promise(() => {
                 process.on("SIGINT", () => {
                     // First, before anything can emit a close event.
                     stopping = true;
-                    channel?.stop();
-                    deliveredReceipts.stop();
-                    try {
-                        getApi().listener.stop();
-                    } catch (e) {
-                        console.error(`[listen] Stop failed: ${e.message}`);
-                    }
-                    clearInterval(heartbeatTimer);
-                    // Stamp "last known connected" at the moment we stop, so a
-                    // deliberate close (or the process simply exiting) gives
-                    // the NEXT launch an accurate window to backfill from,
-                    // rather than treating this whole downtime as unknown.
-                    try {
-                        syncManager.markConnected();
-                    } catch (e) {
-                        console.error(`[listen] Failed to stamp shutdown state: ${e.message}`);
-                    }
-                    releaseLock(accountDir);
-                    info(`Stopped. Uptime: ${uptime()}, events: ${eventCount}, reconnects: ${reconnectCount}`);
-                    const receipts = deliveredReceipts.stats();
-                    if (receipts.calls) {
-                        info(`Delivered receipts: ${receipts.sent} acknowledged, ${receipts.failed} failed`);
-                    }
-                    if (saveDir) info(`Messages saved to: ${saveDir}`);
-                    resolve();
-                    // Resolving the keep-alive promise is not enough: an async
-                    // `closed` handler already in flight resumes after the action
-                    // function has returned and keeps the process alive. mcp.js
-                    // already exits explicitly here for the same reason.
+                    shutdown();
                     process.exit(0);
                 });
+                process.on("SIGTERM", shutdown);
             });
         });
 }

package/src/commands/login.js

@@ -13,8 +13,9 @@ import {
     getApi,
     getOwnId,
 } from "../core/zalo-client.js";
-import { saveCredentials, loadCredentials } from "../core/credentials.js";
-import { addAccount, getActive, removeAccount } from "../core/accounts.js";
+import { saveCredentials, loadCredentials, getAccountDir } from "../core/credentials.js";
+import { addAccount, getActive, removeAccount, updateAccountName } from "../core/accounts.js";
+import { getDaemonStatus } from "../core/daemon-channel.js";
 import { serverLogout, reportLogout, finishLocalLogout, lockHolder } from "../core/logout.js";
 import { maskProxy } from "../utils/proxy-helpers.js";
 import { displayQR, getQRPath } from "../utils/qr-display.js";
@@ -279,12 +280,14 @@ export function registerLoginCommands(program) {
         .description("Show current login status")
         .action(() => {
             const active = getActive();
+            const daemon = active ? getDaemonStatus(getAccountDir(active.ownId)) : null;
             const data = {
                 loggedIn: isLoggedIn(),
                 ownId: getOwnId(),
                 activeAccount: active
                     ? { ownId: active.ownId, name: active.name, proxy: maskProxy(active.proxy) }
                     : null,
+                daemon,
             };
             output(data, program.opts().json, () => {
                 if (data.loggedIn) {
@@ -299,6 +302,15 @@ export function registerLoginCommands(program) {
                     else if (active)
                         info(`Account ${active.name || active.ownId} is logged out — run: zalo-agent login`);
                 }
+                if (daemon) {
+                    if (daemon.running) {
+                        info(
+                            `Daemon: running (PID ${daemon.pid}${daemon.channelPort ? `, channel 127.0.0.1:${daemon.channelPort}` : ""})`,
+                        );
+                    } else {
+                        info("Daemon: not running");
+                    }
+                }
             });
         });
 
@@ -309,8 +321,9 @@ export function registerLoginCommands(program) {
             try {
                 const api = getApi();
                 const accountInfo = await api.fetchAccountInfo();
+                const p = accountInfo?.profile || {};
+                updateAccountName(p.userId || getOwnId(), p.displayName || p.zaloName);
                 output(accountInfo, program.opts().json, () => {
-                    const p = accountInfo?.profile || {};
                     info(`Name: ${p.displayName || "?"}`);
                     info(`ID: ${p.userId || getOwnId()}`);
                     info(`Phone: ${p.phoneNumber || "?"}`);