zalo-agent-cli 1.0.23 → 1.0.25

package/README.md

@@ -231,6 +231,66 @@ zalo-agent whoami
 
 **Privacy settings:** `online-status`, `seen-status`, `birthday`, `receive-msg`, `accept-call`, `add-by-phone`, `add-by-qr`, `add-by-group`, `recommend`
 
+#### Polls (`poll`)
+
+| Command | Description |
+|---------|-------------|
+| `poll create <groupId> <question> <options...>` | Create a poll (see flags below) |
+| `poll info <pollId>` | View poll details and vote results |
+| `poll vote <pollId> <optionIds...>` | Vote on a poll (option IDs from `poll info`) |
+| `poll unvote <pollId>` | Remove your vote |
+| `poll add-option <pollId> <options...> [--vote]` | Add new options to a poll |
+| `poll lock <pollId>` | Close a poll (no more votes) |
+| `poll share <pollId>` | Share a poll |
+
+**Poll create flags:** `--multi` (multiple choices), `--add-options` (members can add options), `--anonymous` (hide voters), `--hide-preview` (hide results until voted), `--expire <minutes>` (auto-close)
+
+**Example:**
+```bash
+# Create a multi-choice poll with 3 options, auto-close after 60 minutes
+zalo-agent poll create <groupId> "Chọn ngày họp" "Thứ 2" "Thứ 4" "Thứ 6" --multi --expire 60
+
+# View results
+zalo-agent poll info <pollId>
+
+# Vote for option IDs 123 and 456
+zalo-agent poll vote <pollId> 123 456
+
+# Close the poll
+zalo-agent poll lock <pollId>
+```
+
+#### Reminders (`reminder`)
+
+| Command | Description |
+|---------|-------------|
+| `reminder create <threadId> <title> [-t 0\|1] [--time "YYYY-MM-DD HH:mm"] [--repeat mode] [--emoji]` | Create a reminder |
+| `reminder list <threadId> [-t 0\|1] [-n count]` | List reminders |
+| `reminder info <reminderId>` | View reminder details (group only) |
+| `reminder responses <reminderId>` | View who accepted/rejected (group only) |
+| `reminder edit <reminderId> <threadId> <title> [-t 0\|1] [--time] [--repeat] [--emoji]` | Edit a reminder |
+| `reminder remove <reminderId> <threadId> [-t 0\|1]` | Remove a reminder |
+
+**Repeat modes:** `none`, `daily`, `weekly`, `monthly`
+
+**Example:**
+```bash
+# Create a daily reminder in a group at 9:00 AM tomorrow
+zalo-agent reminder create <groupId> "Standup meeting" -t 1 --time "2026-03-16 09:00" --repeat daily
+
+# List reminders in a group
+zalo-agent reminder list <groupId> -t 1
+
+# View who responded
+zalo-agent reminder responses <reminderId>
+
+# Edit reminder title and time
+zalo-agent reminder edit <reminderId> <groupId> "New title" -t 1 --time "2026-03-17 10:00"
+
+# Remove a reminder
+zalo-agent reminder remove <reminderId> <groupId> -t 1
+```
+
 #### Accounts (`account`)
 
 | Command | Description |
@@ -470,6 +530,43 @@ zalo-agent profile settings
 zalo-agent profile set online-status 0
 ```
 
+#### 6. Tạo khảo sát (Poll) trong nhóm
+
+```bash
+# Tạo poll multi-choice, tự đóng sau 60 phút
+zalo-agent poll create <groupId> "Chọn ngày họp" "Thứ 2" "Thứ 4" "Thứ 6" --multi --expire 60
+
+# Xem kết quả
+zalo-agent poll info <pollId>
+
+# Bỏ phiếu (dùng option ID từ poll info)
+zalo-agent poll vote <pollId> 123 456
+
+# Đóng poll
+zalo-agent poll lock <pollId>
+```
+
+#### 7. Nhắc nhở (Reminder)
+
+```bash
+# Tạo nhắc nhở hàng ngày trong nhóm lúc 9h sáng
+zalo-agent reminder create <groupId> "Họp standup" -t 1 --time "2026-03-16 09:00" --repeat daily
+
+# Xem danh sách nhắc nhở
+zalo-agent reminder list <groupId> -t 1
+
+# Xem ai đã chấp nhận/từ chối
+zalo-agent reminder responses <reminderId>
+
+# Sửa nhắc nhở
+zalo-agent reminder edit <reminderId> <groupId> "Tiêu đề mới" -t 1 --time "2026-03-17 10:00"
+
+# Xóa nhắc nhở
+zalo-agent reminder remove <reminderId> <groupId> -t 1
+```
+
+Chế độ lặp: `none` (không lặp), `daily` (hàng ngày), `weekly` (hàng tuần), `monthly` (hàng tháng)
+
 ### Danh sách lệnh
 
 Xem đầy đủ tại [phần tiếng Anh](#command-reference) phía trên. Tất cả lệnh đều giống nhau.

package/package.json

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

package/src/commands/poll.js

@@ -0,0 +1,159 @@
+/**
+ * Poll commands — create, view, vote, add options, lock, and share polls in groups.
+ */
+
+import { getApi } from "../core/zalo-client.js";
+import { success, error, info, output } from "../utils/output.js";
+
+export function registerPollCommands(program) {
+    const poll = program.command("poll").description("Create and manage polls in groups");
+
+    poll.command("create <groupId> <question> <options...>")
+        .description("Create a poll in a group (options separated by spaces, quote multi-word options)")
+        .option("--multi", "Allow multiple choices")
+        .option("--add-options", "Allow members to add new options")
+        .option("--anonymous", "Hide voter identities")
+        .option("--hide-preview", "Hide results until voted")
+        .option("--expire <minutes>", "Auto-close after N minutes", parseInt)
+        .action(async (groupId, question, options, opts) => {
+            try {
+                if (options.length < 2) {
+                    error("A poll requires at least 2 options.");
+                    return;
+                }
+                const expiredTime = opts.expire ? opts.expire * 60 * 1000 : 0;
+                const result = await getApi().createPoll(
+                    {
+                        question,
+                        options,
+                        allowMultiChoices: !!opts.multi,
+                        allowAddNewOption: !!opts.addOptions,
+                        isAnonymous: !!opts.anonymous,
+                        hideVotePreview: !!opts.hidePreview,
+                        expiredTime,
+                    },
+                    groupId,
+                );
+                output(result, program.opts().json, () => {
+                    success(`Poll created: "${question}"`);
+                    info(`Poll ID: ${result.poll_id}`);
+                    if (result.options) {
+                        result.options.forEach((o, i) => console.log(`  [${o.option_id}] ${o.content}`));
+                    }
+                });
+            } catch (e) {
+                error(`Create poll failed: ${e.message}`);
+            }
+        });
+
+    poll.command("info <pollId>")
+        .description("View poll details and results")
+        .action(async (pollId) => {
+            try {
+                const result = await getApi().getPollDetail(Number(pollId));
+                output(result, program.opts().json, () => {
+                    info(`Question: ${result.question}`);
+                    info(`Poll ID: ${result.poll_id}`);
+                    info(`Status: ${result.closed ? "Closed" : "Open"}`);
+                    info(`Total votes: ${result.num_vote}`);
+                    info(`Multi-choice: ${result.allow_multi_choices ? "Yes" : "No"}`);
+                    info(`Anonymous: ${result.is_anonymous ? "Yes" : "No"}`);
+                    if (result.expired_time > 0) {
+                        const expDate = new Date(result.expired_time);
+                        info(`Expires: ${expDate.toLocaleString()}`);
+                    }
+                    console.log();
+                    console.log("  ID    VOTES  OPTION");
+                    console.log("  " + "-".repeat(50));
+                    for (const o of result.options || []) {
+                        const voted = o.voted ? " ✓" : "";
+                        console.log(
+                            `  ${String(o.option_id).padEnd(6)} ${String(o.votes).padEnd(6)} ${o.content}${voted}`,
+                        );
+                    }
+                });
+            } catch (e) {
+                error(`Get poll failed: ${e.message}`);
+            }
+        });
+
+    poll.command("vote <pollId> <optionIds...>")
+        .description("Vote on a poll (use option IDs from 'poll info')")
+        .action(async (pollId, optionIds) => {
+            try {
+                const ids = optionIds.map(Number);
+                const result = await getApi().votePoll(Number(pollId), ids);
+                output(result, program.opts().json, () => {
+                    success(`Voted on poll ${pollId}`);
+                    if (result.options) {
+                        for (const o of result.options) {
+                            const voted = o.voted ? " ✓" : "";
+                            console.log(`  [${o.option_id}] ${o.content}: ${o.votes} vote(s)${voted}`);
+                        }
+                    }
+                });
+            } catch (e) {
+                error(`Vote failed: ${e.message}`);
+            }
+        });
+
+    poll.command("unvote <pollId>")
+        .description("Remove your vote from a poll")
+        .action(async (pollId) => {
+            try {
+                const result = await getApi().votePoll(Number(pollId), []);
+                output(result, program.opts().json, () => success(`Removed vote from poll ${pollId}`));
+            } catch (e) {
+                error(`Unvote failed: ${e.message}`);
+            }
+        });
+
+    poll.command("add-option <pollId> <options...>")
+        .description("Add new options to an existing poll")
+        .option("--vote", "Also vote for the new options")
+        .action(async (pollId, options, opts) => {
+            try {
+                const newOptions = options.map((content) => ({
+                    content,
+                    voted: !!opts.vote,
+                }));
+                const result = await getApi().addPollOptions({
+                    pollId: Number(pollId),
+                    options: newOptions,
+                    votedOptionIds: [],
+                });
+                output(result, program.opts().json, () => {
+                    success(`Added ${options.length} option(s) to poll ${pollId}`);
+                    if (result.options) {
+                        for (const o of result.options) {
+                            console.log(`  [${o.option_id}] ${o.content}: ${o.votes} vote(s)`);
+                        }
+                    }
+                });
+            } catch (e) {
+                error(`Add option failed: ${e.message}`);
+            }
+        });
+
+    poll.command("lock <pollId>")
+        .description("Lock/close a poll (no more votes)")
+        .action(async (pollId) => {
+            try {
+                const result = await getApi().lockPoll(Number(pollId));
+                output(result, program.opts().json, () => success(`Poll ${pollId} locked`));
+            } catch (e) {
+                error(`Lock poll failed: ${e.message}`);
+            }
+        });
+
+    poll.command("share <pollId>")
+        .description("Share a poll")
+        .action(async (pollId) => {
+            try {
+                const result = await getApi().sharePoll(Number(pollId));
+                output(result, program.opts().json, () => success(`Poll ${pollId} shared`));
+            } catch (e) {
+                error(`Share poll failed: ${e.message}`);
+            }
+        });
+}

package/src/commands/profile.js

@@ -18,7 +18,7 @@ const SETTING_MAP = {
         label: "Display seen status",
         values: { 0: "hidden", 1: "visible" },
     },
-    "birthday": {
+    birthday: {
         key: "view_birthday",
         label: "Birthday visibility",
         values: { 0: "hidden", 1: "full (day/month/year)", 2: "partial (day/month)" },
@@ -48,7 +48,7 @@ const SETTING_MAP = {
         label: "Find via group",
         values: { 0: "disabled", 1: "enabled" },
     },
-    "recommend": {
+    recommend: {
         key: "display_on_recommend_friend",
         label: "Show in friend recommendations",
         values: { 0: "disabled", 1: "enabled" },
@@ -111,7 +111,9 @@ export function registerProfileCommands(program) {
                     } else {
                         output({ bio: newBio, requested: text }, program.opts().json, () => {
                             success(`Bio update request sent: "${text}"`);
-                            info("Note: Zalo may take time to reflect changes, or bio may not be supported for your account type.");
+                            info(
+                                "Note: Zalo may take time to reflect changes, or bio may not be supported for your account type.",
+                            );
                         });
                     }
                 }
@@ -145,7 +147,7 @@ export function registerProfileCommands(program) {
                     profile: {
                         name: opts.name || p.displayName || p.zaloName,
                         dob: opts.dob || currentDob,
-                        gender: opts.gender !== undefined ? Number(opts.gender) : p.gender ?? 0,
+                        gender: opts.gender !== undefined ? Number(opts.gender) : (p.gender ?? 0),
                     },
                 };
                 const result = await getApi().updateProfile(payload);
@@ -193,14 +195,14 @@ export function registerProfileCommands(program) {
                 const numVal = Number(value);
                 if (!(numVal in meta.values)) {
                     error(
-                        `Invalid value for ${setting}. Valid: ${Object.entries(meta.values).map(([k, v]) => `${k}=${v}`).join(", ")}`,
+                        `Invalid value for ${setting}. Valid: ${Object.entries(meta.values)
+                            .map(([k, v]) => `${k}=${v}`)
+                            .join(", ")}`,
                     );
                     return;
                 }
                 const result = await getApi().updateSettings(meta.key, numVal);
-                output(result, program.opts().json, () =>
-                    success(`${meta.label}: ${meta.values[numVal]} (${numVal})`),
-                );
+                output(result, program.opts().json, () => success(`${meta.label}: ${meta.values[numVal]} (${numVal})`));
             } catch (e) {
                 error(`Setting update failed: ${e.message}`);
             }

package/src/commands/reminder.js

@@ -0,0 +1,195 @@
+/**
+ * Reminder commands — create, list, info, edit, remove reminders in users/groups.
+ */
+
+import { getApi } from "../core/zalo-client.js";
+import { success, error, info, output } from "../utils/output.js";
+
+/** Repeat mode labels matching zca-js ReminderRepeatMode enum. */
+const REPEAT_MODES = { none: 0, daily: 1, weekly: 2, monthly: 3 };
+const REPEAT_LABELS = { 0: "None", 1: "Daily", 2: "Weekly", 3: "Monthly" };
+
+/** Parse a datetime string into Unix timestamp (ms). Accepts ISO or "YYYY-MM-DD HH:mm". */
+function parseTime(str) {
+    // Try "YYYY-MM-DD HH:mm" format
+    const match = str.match(/^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2})$/);
+    if (match) {
+        const [, y, mo, d, h, mi] = match;
+        return new Date(Number(y), Number(mo) - 1, Number(d), Number(h), Number(mi)).getTime();
+    }
+    // Fallback to Date.parse (ISO, etc.)
+    const ts = Date.parse(str);
+    if (isNaN(ts)) return null;
+    return ts;
+}
+
+export function registerReminderCommands(program) {
+    const reminder = program.command("reminder").description("Create and manage reminders in users/groups");
+
+    reminder
+        .command("create <threadId> <title>")
+        .description("Create a reminder")
+        .option("-t, --type <n>", "Thread type: 0=User, 1=Group", "0")
+        .option("--time <datetime>", 'Reminder time: "YYYY-MM-DD HH:mm" (default: now)')
+        .option("--emoji <emoji>", "Emoji icon", "⏰")
+        .option("--repeat <mode>", "Repeat: none, daily, weekly, monthly", "none")
+        .action(async (threadId, title, opts) => {
+            try {
+                const repeatMode = REPEAT_MODES[opts.repeat];
+                if (repeatMode === undefined) {
+                    error(`Invalid repeat mode: "${opts.repeat}". Valid: none, daily, weekly, monthly`);
+                    return;
+                }
+                let startTime = Date.now();
+                if (opts.time) {
+                    startTime = parseTime(opts.time);
+                    if (!startTime) {
+                        error(`Invalid time format: "${opts.time}". Use "YYYY-MM-DD HH:mm" or ISO format.`);
+                        return;
+                    }
+                }
+                const result = await getApi().createReminder(
+                    { title, emoji: opts.emoji, startTime, repeat: repeatMode },
+                    threadId,
+                    Number(opts.type),
+                );
+                output(result, program.opts().json, () => {
+                    success(`Reminder created: "${title}"`);
+                    const id = result.reminderId || result.id || "?";
+                    info(`Reminder ID: ${id}`);
+                    info(`Time: ${new Date(startTime).toLocaleString()}`);
+                    if (repeatMode > 0) info(`Repeat: ${REPEAT_LABELS[repeatMode]}`);
+                });
+            } catch (e) {
+                error(`Create reminder failed: ${e.message}`);
+            }
+        });
+
+    reminder
+        .command("list <threadId>")
+        .description("List reminders in a thread")
+        .option("-t, --type <n>", "Thread type: 0=User, 1=Group", "0")
+        .option("-n, --count <n>", "Max results", "20")
+        .action(async (threadId, opts) => {
+            try {
+                let result;
+                try {
+                    result = await getApi().getListReminder({ count: Number(opts.count) }, threadId, Number(opts.type));
+                } catch {
+                    result = null;
+                }
+                const items = Array.isArray(result) ? result : [];
+                output(items, program.opts().json, () => {
+                    if (items.length === 0) {
+                        info("No reminders found.");
+                        return;
+                    }
+                    info(`${items.length} reminder(s):`);
+                    console.log();
+                    for (const r of items) {
+                        const id = r.reminderId || r.id || "?";
+                        const title = r.params?.title || "?";
+                        const time = new Date(r.startTime).toLocaleString();
+                        const repeat = REPEAT_LABELS[r.repeat] || "None";
+                        const emoji = r.emoji || "";
+                        console.log(`  ${emoji} [${id}] ${title}`);
+                        console.log(`     Time: ${time} | Repeat: ${repeat}`);
+                    }
+                });
+            } catch (e) {
+                error(`List reminders failed: ${e.message}`);
+            }
+        });
+
+    reminder
+        .command("info <reminderId>")
+        .description("View reminder details (group reminders only)")
+        .action(async (reminderId) => {
+            try {
+                const result = await getApi().getReminder(reminderId);
+                output(result, program.opts().json, () => {
+                    const title = result.params?.title || "?";
+                    const id = result.id || reminderId;
+                    info(`Title: ${result.emoji || ""} ${title}`);
+                    info(`Reminder ID: ${id}`);
+                    info(`Created: ${new Date(result.createTime).toLocaleString()}`);
+                    info(`Time: ${new Date(result.startTime).toLocaleString()}`);
+                    info(`Repeat: ${REPEAT_LABELS[result.repeat] || "None"}`);
+                    info(`Creator: ${result.creatorId}`);
+                    if (result.responseMem) {
+                        info(
+                            `Responses: ${result.responseMem.acceptMember} accepted, ${result.responseMem.rejectMember} rejected`,
+                        );
+                    }
+                });
+            } catch (e) {
+                error(`Get reminder failed: ${e.message}`);
+            }
+        });
+
+    reminder
+        .command("responses <reminderId>")
+        .description("View who accepted/rejected a reminder (group only)")
+        .action(async (reminderId) => {
+            try {
+                const result = await getApi().getReminderResponses(reminderId);
+                output(result, program.opts().json, () => {
+                    const accepted = result.acceptMember || [];
+                    const rejected = result.rejectMember || [];
+                    info(`Accepted (${accepted.length}):`);
+                    accepted.forEach((uid) => console.log(`  ✓ ${uid}`));
+                    info(`Rejected (${rejected.length}):`);
+                    rejected.forEach((uid) => console.log(`  ✗ ${uid}`));
+                });
+            } catch (e) {
+                error(`Get responses failed: ${e.message}`);
+            }
+        });
+
+    reminder
+        .command("edit <reminderId> <threadId> <title>")
+        .description("Edit a reminder")
+        .option("-t, --type <n>", "Thread type: 0=User, 1=Group", "0")
+        .option("--time <datetime>", 'New time: "YYYY-MM-DD HH:mm"')
+        .option("--emoji <emoji>", "New emoji icon")
+        .option("--repeat <mode>", "Repeat: none, daily, weekly, monthly")
+        .action(async (reminderId, threadId, title, opts) => {
+            try {
+                const editOpts = { title, topicId: reminderId };
+                if (opts.emoji) editOpts.emoji = opts.emoji;
+                if (opts.time) {
+                    const ts = parseTime(opts.time);
+                    if (!ts) {
+                        error(`Invalid time format: "${opts.time}". Use "YYYY-MM-DD HH:mm".`);
+                        return;
+                    }
+                    editOpts.startTime = ts;
+                }
+                if (opts.repeat) {
+                    const mode = REPEAT_MODES[opts.repeat];
+                    if (mode === undefined) {
+                        error(`Invalid repeat mode: "${opts.repeat}". Valid: none, daily, weekly, monthly`);
+                        return;
+                    }
+                    editOpts.repeat = mode;
+                }
+                const result = await getApi().editReminder(editOpts, threadId, Number(opts.type));
+                output(result, program.opts().json, () => success(`Reminder ${reminderId} updated`));
+            } catch (e) {
+                error(`Edit reminder failed: ${e.message}`);
+            }
+        });
+
+    reminder
+        .command("remove <reminderId> <threadId>")
+        .description("Remove a reminder")
+        .option("-t, --type <n>", "Thread type: 0=User, 1=Group", "0")
+        .action(async (reminderId, threadId, opts) => {
+            try {
+                const result = await getApi().removeReminder(reminderId, threadId, Number(opts.type));
+                output(result, program.opts().json, () => success(`Reminder ${reminderId} removed`));
+            } catch (e) {
+                error(`Remove reminder failed: ${e.message}`);
+            }
+        });
+}

package/src/index.js

@@ -19,12 +19,15 @@ import { registerGroupCommands } from "./commands/group.js";
 import { registerConvCommands } from "./commands/conv.js";
 import { registerAccountCommands } from "./commands/account.js";
 import { registerProfileCommands } from "./commands/profile.js";
+import { registerPollCommands } from "./commands/poll.js";
+import { registerReminderCommands } from "./commands/reminder.js";
 import { registerListenCommand } from "./commands/listen.js";
 import { autoLogin } from "./core/zalo-client.js";
 import { checkForUpdates, selfUpdate } from "./utils/update-check.js";
 import { success, error, warning } from "./utils/output.js";
 
-const DISCLAIMER = "This tool uses unofficial Zalo APIs (zca-js) — your account may be banned. Use at your own risk. | Tool này dùng API Zalo không chính thức (zca-js) — account có thể bị ban. Tự chịu trách nhiệm.";
+const DISCLAIMER =
+    "This tool uses unofficial Zalo APIs (zca-js) — your account may be banned. Use at your own risk. | Tool này dùng API Zalo không chính thức (zca-js) — account có thể bị ban. Tự chịu trách nhiệm.";
 
 const program = new Command();
 
@@ -71,6 +74,8 @@ registerGroupCommands(program);
 registerConvCommands(program);
 registerAccountCommands(program);
 registerProfileCommands(program);
+registerPollCommands(program);
+registerReminderCommands(program);
 registerListenCommand(program);
 
 program.parse();