lalo-cli 0.2.0

package/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+Copyright 2026 Diginno
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,36 @@
+# LALO CLI
+
+Lệnh máy để đọc chat Zalo đã vào LALO, ghi hồ sơ khách, để bình luận nội bộ, và soạn/gửi tin có bước duyệt. **Không** đăng nhập Zalo trên máy bạn — dùng nick đang chạy trên LALO + khoá có phạm vi.
+
+Cài:
+
+```bash
+npm install -g lalo-cli
+lalo --help
+```
+
+Lệnh trên máy là `lalo` (còn alias `zalocrm-cli` trong phiên bản này). Tên gói npm là `lalo-cli` vì tổ chức `@lalo` trên npm đã có chủ khác.
+
+## Cấu hình 5 phút
+
+```bash
+lalo config set server https://chat.diginno.net
+lalo config set api-key <KEY>
+lalo auth status
+```
+
+Khoá tạo trong LALO › Cài đặt › Khoá API, loại CLI, giới hạn nick và quyền. `auth status` hiện tổ chức, nick, quyền, hạn dùng — **không** in lại khoá thô.
+
+Biến môi trường (CI): `LALO_BASE_URL`, `LALO_API_KEY`. Tên cũ `ZALOCRM_CLI_*` vẫn nhận, có cảnh báo.
+
+Lệnh cũ `zalocrm-cli` vẫn chạy trong phiên bản này.
+
+## Lệnh chính
+
+- `lalo conv list|scan|sweep` — hội thoại / tin nhắn
+- `lalo comment list|add` — bình luận nội bộ (không gửi Zalo)
+- `lalo contact facts|fact-add` — sự thật bền trên hồ sơ khách
+- `lalo tag list|show|apply` — tag CRM
+- `lalo msg draft|send|send-file` — nháp / gửi có duyệt
+
+Gửi tin mặc định **chỉ xem trước**. Có `--confirm` mới gửi thật.

package/dist/api-client.js

@@ -0,0 +1,108 @@
+import { readFile } from 'node:fs/promises';
+import { basename, extname } from 'node:path';
+import { loadConfig, CliConfigError } from './config.js';
+export { CliConfigError };
+const MIME_BY_EXT = {
+    '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png', '.webp': 'image/webp', '.gif': 'image/gif',
+    '.mp4': 'video/mp4', '.mov': 'video/quicktime', '.webm': 'video/webm',
+    '.pdf': 'application/pdf',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    '.xls': 'application/vnd.ms-excel',
+    '.csv': 'text/csv',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.doc': 'application/msword',
+    '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    '.ppt': 'application/vnd.ms-powerpoint',
+    '.zip': 'application/zip',
+    '.gz': 'application/gzip',
+    '.rar': 'application/vnd.rar',
+    '.tar': 'application/x-tar',
+};
+/** Đọc cấu hình: cờ lệnh → LALO_* → ZALOCRM_CLI_* (cảnh báo) → file ~/.config/lalo. */
+export function loadConfigFromEnv() {
+    return loadConfig();
+}
+/** Chốt chặn chạy loạn cho `--all`: 50 trang × limit tối đa 200 = 10.000 bản ghi. */
+const MAX_AUTO_PAGES = 50;
+/**
+ * Lật hết trang bằng offset cho tới khi `hasMore=false`.
+ * `order='prepend'` dành cho danh sách trả về mới→cũ nhưng in ra cũ→mới (tin nhắn):
+ * trang sau chứa dữ liệu cũ hơn nên phải ghép lên đầu.
+ */
+export async function fetchAllPages(fetchPage, getItems, merge, order = 'append') {
+    let offset = 0;
+    let page = 0;
+    let acc = [];
+    let last;
+    for (;;) {
+        last = await fetchPage(offset);
+        const items = getItems(last);
+        acc = order === 'prepend' ? [...items, ...acc] : [...acc, ...items];
+        offset += items.length;
+        page += 1;
+        // items rỗng mà vẫn hasMore ⇒ dừng, nếu không sẽ lặp vô hạn tại chỗ.
+        if (!last.hasMore || items.length === 0)
+            break;
+        if (page >= MAX_AUTO_PAGES) {
+            process.stderr.write(`⚠ --all dừng ở ${MAX_AUTO_PAGES} trang (${acc.length} bản ghi) để không chạy loạn. `
+                + `Còn dữ liệu chưa lấy — thu hẹp bộ lọc, hoặc chạy tiếp với --offset ${offset}.\n`);
+            break;
+        }
+    }
+    return merge(last, acc);
+}
+export async function cliGet(config, path, query = {}) {
+    const url = new URL(config.baseUrl + path);
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined && value !== '')
+            url.searchParams.set(key, String(value));
+    }
+    const res = await fetch(url, { headers: { 'X-Cli-Token': config.token } });
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok) {
+        const err = body;
+        const suffix = err.errorCode ? ` ${err.errorCode}` : '';
+        throw new Error(`[${res.status}${suffix}] ${err.error ?? 'Request failed'}`);
+    }
+    return body;
+}
+export async function cliPost(config, path, body) {
+    const res = await fetch(config.baseUrl + path, {
+        method: 'POST',
+        headers: { 'X-Cli-Token': config.token, 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    const responseBody = await res.json().catch(() => ({}));
+    if (!res.ok) {
+        const err = responseBody;
+        const suffix = err.errorCode ? ` ${err.errorCode}` : '';
+        throw new Error(`[${res.status}${suffix}] ${err.error ?? 'Request failed'}`);
+    }
+    return responseBody;
+}
+/** Gửi 1 file local kèm field text (mode/testToConversationId/caption) — fields đi TRƯỚC file trong FormData, khớp thứ tự backend giả định. */
+export async function cliPostFile(config, path, filePath, fields) {
+    const buffer = await readFile(filePath);
+    const ext = extname(filePath).toLowerCase();
+    const mimeType = MIME_BY_EXT[ext] ?? 'application/octet-stream';
+    const filename = basename(filePath);
+    const formData = new FormData();
+    for (const [key, value] of Object.entries(fields)) {
+        if (value !== undefined && value !== '')
+            formData.append(key, value);
+    }
+    formData.append('file', new Blob([buffer], { type: mimeType }), filename);
+    const res = await fetch(config.baseUrl + path, {
+        method: 'POST',
+        headers: { 'X-Cli-Token': config.token },
+        body: formData,
+    });
+    const responseBody = await res.json().catch(() => ({}));
+    if (!res.ok) {
+        const err = responseBody;
+        const suffix = err.errorCode ? ` ${err.errorCode}` : '';
+        throw new Error(`[${res.status}${suffix}] ${err.error ?? 'Request failed'}`);
+    }
+    return responseBody;
+}
+//# sourceMappingURL=api-client.js.map

package/dist/config.js

@@ -0,0 +1,84 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+export class CliConfigError extends Error {
+}
+let warnedLegacyEnv = false;
+let runtimeOverrides = {};
+export function setRuntimeOverrides(input) {
+    runtimeOverrides = input;
+}
+export function configDir() {
+    if (process.platform === 'win32') {
+        const roaming = process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
+        return join(roaming, 'LALO');
+    }
+    const xdg = process.env.XDG_CONFIG_HOME || join(homedir(), '.config');
+    return join(xdg, 'lalo');
+}
+export function configPath() {
+    return join(configDir(), 'config.json');
+}
+export function maskKey(raw) {
+    if (!raw)
+        return '(chưa có)';
+    if (raw.length <= 12)
+        return `${raw.slice(0, 4)}…`;
+    return `${raw.slice(0, 12)}…`;
+}
+async function readConfigFile() {
+    try {
+        const raw = await readFile(configPath(), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || !parsed.profiles) {
+            return { profiles: {} };
+        }
+        return parsed;
+    }
+    catch {
+        return { profiles: {} };
+    }
+}
+async function writeConfigFile(file) {
+    const dest = configPath();
+    await mkdir(dirname(dest), { recursive: true, mode: 0o700 });
+    await writeFile(dest, `${JSON.stringify(file, null, 2)}\n`, { mode: 0o600, encoding: 'utf8' });
+}
+export async function getProfile(name = 'default') {
+    const file = await readConfigFile();
+    return file.profiles[name] ?? {};
+}
+export async function setProfileValues(values, name = 'default') {
+    const file = await readConfigFile();
+    file.profiles[name] = { ...file.profiles[name], ...values };
+    await writeConfigFile(file);
+    return file.profiles[name];
+}
+export async function unsetProfileKey(field, name = 'default') {
+    const file = await readConfigFile();
+    if (!file.profiles[name])
+        return;
+    delete file.profiles[name][field];
+    await writeConfigFile(file);
+}
+export async function loadConfig(input = {}) {
+    const merged = { ...runtimeOverrides, ...input };
+    const profileName = merged.profile || 'default';
+    const stored = await getProfile(profileName);
+    const legacyUrl = process.env.ZALOCRM_CLI_BASE_URL;
+    const legacyToken = process.env.ZALOCRM_CLI_TOKEN;
+    if ((legacyUrl || legacyToken) && !warnedLegacyEnv) {
+        warnedLegacyEnv = true;
+        process.stderr.write('⚠ Biến ZALOCRM_CLI_* sẽ bỏ sau một phiên bản. Đổi sang LALO_BASE_URL / LALO_API_KEY, hoặc `lalo config set`.\n');
+    }
+    const baseUrl = (merged.server || process.env.LALO_BASE_URL || legacyUrl || stored.server || '').replace(/\/$/, '');
+    const token = merged.apiKey || process.env.LALO_API_KEY || legacyToken || stored.apiKey || '';
+    if (!baseUrl) {
+        throw new CliConfigError('Thiếu địa chỉ máy chủ. Chạy `lalo config set server https://chat.diginno.net` hoặc đặt LALO_BASE_URL.');
+    }
+    if (!token) {
+        throw new CliConfigError('Thiếu khoá API. Chạy `lalo config set api-key <KEY>` (tạo khoá trong LALO › Cài đặt › Khoá API, quyền CLI) hoặc đặt LALO_API_KEY.');
+    }
+    return { baseUrl, token };
+}
+//# sourceMappingURL=config.js.map

package/dist/index.js

@@ -0,0 +1,381 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { cliGet, cliPost, cliPostFile, fetchAllPages, loadConfigFromEnv } from './api-client.js';
+import { configPath, getProfile, loadConfig, maskKey, setProfileValues, setRuntimeOverrides, unsetProfileKey, } from './config.js';
+import { printContactFacts, printDraftResult, printJson, printScanResult, printSendAttachmentResult, printApplyTagsResult, printSendResult, printSweepResult, printTagCatalog, printTagsOfTarget, printThreadsTable, printWriteContactFacts, printConversationComments, printAddConversationComment, } from './output.js';
+if (process.argv[1]?.includes('zalocrm-cli')) {
+    process.stderr.write('⚠ `zalocrm-cli` sẽ bỏ sau một phiên bản. Dùng lệnh `lalo`.\n');
+}
+const program = new Command();
+program
+    .name('lalo')
+    .description('LALO CLI — đọc chat / ghi hồ sơ / bình luận nội bộ / gửi tin qua LALO. Không tự đăng nhập Zalo. Lệnh cũ `zalocrm-cli` vẫn chạy trong phiên bản này.')
+    .version('0.2.0')
+    .option('--server <url>', 'Địa chỉ LALO (thắng file cấu hình)')
+    .option('--api-key <key>', 'Khoá CLI (thắng file cấu hình, không in ra log)')
+    .option('--profile <name>', 'Hồ sơ cấu hình (mặc định: default)')
+    .hook('preAction', (thisCommand) => {
+    const o = thisCommand.optsWithGlobals();
+    setRuntimeOverrides({ server: o.server, apiKey: o.apiKey, profile: o.profile });
+});
+const configCmd = program.command('config').description('Cấu hình máy chủ và khoá API trên máy này');
+configCmd
+    .command('set')
+    .description('Lưu server hoặc api-key vào hồ sơ local (file chỉ user đọc được)')
+    .argument('<field>', 'server | api-key')
+    .argument('<value>', 'Giá trị')
+    .action(async (field, value, _opts, cmd) => {
+    const profile = cmd.optsWithGlobals().profile || 'default';
+    if (field !== 'server' && field !== 'api-key') {
+        console.error('Chỉ nhận field `server` hoặc `api-key`.');
+        process.exitCode = 1;
+        return;
+    }
+    const saved = await setProfileValues(field === 'server' ? { server: value } : { apiKey: value }, profile);
+    if (field === 'api-key') {
+        console.log(`Đã lưu khoá ${maskKey(saved.apiKey)} vào hồ sơ \`${profile}\`.`);
+    }
+    else {
+        console.log(`Đã lưu server ${saved.server} vào hồ sơ \`${profile}\`.`);
+    }
+});
+configCmd
+    .command('show')
+    .description('Hiện cấu hình đang dùng — khoá chỉ hiện prefix')
+    .action(async (_opts, cmd) => {
+    const profile = cmd.optsWithGlobals().profile || 'default';
+    const stored = await getProfile(profile);
+    let resolved = null;
+    try {
+        resolved = await loadConfig({ profile });
+    }
+    catch {
+        resolved = null;
+    }
+    console.log(`Hồ sơ: ${profile}`);
+    console.log(`File:  ${configPath()}`);
+    console.log(`Server đã lưu: ${stored.server || '(chưa có)'}`);
+    console.log(`Khoá đã lưu:   ${maskKey(stored.apiKey)}`);
+    if (resolved) {
+        console.log(`Server hiệu lực: ${resolved.baseUrl}`);
+        console.log(`Khoá hiệu lực:   ${maskKey(resolved.token)}`);
+    }
+    else {
+        console.log('Chưa đủ server + khoá để gọi máy chủ.');
+    }
+});
+configCmd
+    .command('unset')
+    .description('Xóa server hoặc api-key khỏi hồ sơ local')
+    .argument('<field>', 'server | api-key')
+    .action(async (field, _opts, cmd) => {
+    const profile = cmd.optsWithGlobals().profile || 'default';
+    if (field !== 'server' && field !== 'api-key') {
+        console.error('Chỉ nhận field `server` hoặc `api-key`.');
+        process.exitCode = 1;
+        return;
+    }
+    await unsetProfileKey(field === 'server' ? 'server' : 'apiKey', profile);
+    console.log(`Đã xóa \`${field}\` khỏi hồ sơ \`${profile}\`.`);
+});
+program
+    .command('auth')
+    .description('Kiểm tra khoá CLI với máy chủ')
+    .command('status')
+    .description('Kiểm tra khoá: tổ chức, nick được phép, quyền, hạn dùng — không in khoá thô')
+    .option('--json', 'In JSON đầy đủ')
+    .action(async (opts) => {
+    const config = await loadConfigFromEnv();
+    const data = await cliGet(config, '/api/cli/auth/status');
+    if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    console.log(`Tổ chức: ${data.org.name ?? data.org.id}`);
+    console.log(`Khoá:    ${data.key.name} (${data.key.prefix}…) · ${data.key.kind}`);
+    console.log(`Quyền:   ${data.key.scopes.join(', ') || '(không)'}`);
+    console.log(`Hạn dùng: ${data.key.expiresAt ?? 'không hết hạn'}`);
+    if (data.user)
+        console.log(`Người:   ${data.user.name} <${data.user.email}>`);
+    if (data.nicks.all)
+        console.log('Nick:    mọi nick trong tổ chức');
+    else if (data.nicks.items.length === 0)
+        console.log('Nick:    (danh sách trống)');
+    else {
+        console.log('Nick:');
+        for (const nick of data.nicks.items) {
+            console.log(`  - ${nick.name ?? nick.id}`);
+        }
+    }
+});
+const conv = program.command('conv').description('Hội thoại (conversation/thread) của 1 nick Zalo');
+conv
+    .command('list')
+    .description('Liệt kê hội thoại (DM hoặc nhóm) của 1 nick Zalo, mới nhất trước')
+    .requiredOption('--account <zaloAccountId>', 'ID Zalo account (nick) trong LALO')
+    .option('--type <type>', 'group | user | all', 'all')
+    .option('--search <text>', 'Lọc theo tên nhóm/tên khách')
+    .option('--limit <n>', 'Số hội thoại mỗi trang (mặc định 30, tối đa 100)', '30')
+    .option('--offset <n>', 'Bỏ qua N hội thoại đầu — dùng để lật trang tiếp theo', '0')
+    .option('--all', 'Tự lật hết mọi trang cho tới khi hết hội thoại (bỏ qua --offset)')
+    .option('--json', 'In JSON đầy đủ thay vì bảng gọn')
+    .action(async (opts) => {
+    const config = await loadConfigFromEnv();
+    const fetchPage = (offset) => cliGet(config, `/api/cli/zalo-accounts/${opts.account}/threads`, {
+        threadType: opts.type,
+        search: opts.search,
+        limit: opts.limit,
+        offset,
+    });
+    const data = opts.all
+        ? await fetchAllPages(fetchPage, (d) => d.threads, (d, threads) => ({ ...d, threads, offset: 0, hasMore: false }))
+        : await fetchPage(Number(opts.offset) || 0);
+    if (opts.json)
+        printJson(data);
+    else
+        printThreadsTable(data);
+});
+conv
+    .command('scan')
+    .description('Đọc tin nhắn gần đây trong 1 hội thoại (DM hoặc nhóm), cũ → mới')
+    .requiredOption('--conversation <conversationId>', 'ID hội thoại trong LALO (lấy từ `conv list`)')
+    .option('--limit <n>', 'Số tin mỗi trang (mặc định 50, tối đa 200)', '50')
+    .option('--offset <n>', 'Bỏ qua N tin mới nhất — dùng để lấy tiếp phần cũ hơn', '0')
+    .option('--all', 'Tự lật hết mọi trang cho tới khi hết tin trong khung giờ (bỏ qua --offset)')
+    .option('--since-hours <n>', 'Chỉ lấy tin trong N giờ gần đây')
+    .option('--search <text>', 'Chỉ lấy tin có chứa từ khoá này (không phân biệt hoa/thường)')
+    .option('--json', 'In JSON đầy đủ thay vì danh sách gọn')
+    .action(async (opts) => {
+    const config = await loadConfigFromEnv();
+    const fetchPage = (offset) => cliGet(config, `/api/cli/conversations/${opts.conversation}/messages`, {
+        limit: opts.limit,
+        offset,
+        sinceHours: opts.sinceHours,
+        search: opts.search,
+    });
+    // Mỗi trang đã đảo cũ→mới; trang sau là tin CŨ HƠN nên phải ghép lên trước.
+    const data = opts.all
+        ? await fetchAllPages(fetchPage, (d) => d.messages, (d, pages) => ({
+            ...d, messages: pages, offset: 0, hasMore: false, truncated: false,
+        }), 'prepend')
+        : await fetchPage(Number(opts.offset) || 0);
+    if (opts.json)
+        printJson(data);
+    else
+        printScanResult(data);
+});
+conv
+    .command('sweep')
+    .description('Quét MỌI hội thoại có tin trong N giờ gần đây (mặc định 24h), gom theo hội thoại kèm nguồn — dùng để tóm tắt bản tin tổng hợp')
+    .option('--account <zaloAccountId>', 'Chỉ quét 1 nick; bỏ trống = quét mọi nick trong org')
+    .option('--since-hours <n>', 'Khung giờ quét ngược về trước (mặc định 24)', '24')
+    .option('--type <type>', 'group | user | all', 'all')
+    .option('--search <text>', 'Chỉ lấy tin có chứa từ khoá này')
+    .option('--limit <n>', 'Trần TỔNG số tin lấy về, không phải mỗi hội thoại (mặc định 500, tối đa 2000)', '500')
+    .option('--json', 'In JSON đầy đủ thay vì bản tóm gọn')
+    .action(async (opts) => {
+    const config = await loadConfigFromEnv();
+    const data = await cliGet(config, '/api/cli/sweep', {
+        zaloAccountId: opts.account,
+        sinceHours: opts.sinceHours,
+        threadType: opts.type,
+        search: opts.search,
+        limit: opts.limit,
+    });
+    if (opts.json)
+        printJson(data);
+    else
+        printSweepResult(data);
+});
+const contact = program
+    .command('contact')
+    .description('Hồ sơ khách của 1 hội thoại — ghi nhớ ("sự thật bền") mà AI đọc lại ở mọi lần trả lời sau');
+contact
+    .command('facts')
+    .description('Xem các ghi nhớ đang lưu về khách của 1 hội thoại (DM). Chạy lệnh này TRƯỚC khi ghi thêm để không ghi trùng.')
+    .requiredOption('--conversation <conversationId>', 'ID hội thoại trong LALO (lấy từ `conv list`)')
+    .option('--json', 'In JSON đầy đủ')
+    .action(async (opts) => {
+    const config = await loadConfigFromEnv();
+    const data = await cliGet(config, `/api/cli/conversations/${opts.conversation}/contact-facts`);
+    if (opts.json)
+        printJson(data);
+    else
+        printContactFacts(data);
+});
+contact
+    .command('fact-add')
+    .description('Ghi THẲNG ghi nhớ mới về khách của hội thoại này — ghi luôn, không có bước duyệt. Mỗi câu vào sổ lịch sử (kèm hội thoại nguồn) và hoàn tác được trong app.')
+    .requiredOption('--conversation <conversationId>', 'ID hội thoại trong LALO (lấy từ `conv list`)')
+    .requiredOption('--text <text...>', 'Câu cần nhớ (≤300 ký tự). Lặp lại --text để ghi nhiều câu, tối đa 10 câu/lần.')
+    .option('--json', 'In JSON đầy đủ')
+    .action(async (opts) => {
+    const texts = Array.isArray(opts.text) ? opts.text : [opts.text];
+    const config = await loadConfigFromEnv();
+    const data = await cliPost(config, `/api/cli/conversations/${opts.conversation}/contact-facts`, { texts });
+    if (opts.json)
+        printJson(data);
+    else
+        printWriteContactFacts(data);
+});
+const tag = program.command('tag').description('Tag CRM — xem danh mục và gắn tag sau khi đọc chat');
+tag
+    .command('list')
+    .description('Danh mục tag CRM của org, kèm chính sách AI từng tag (auto/suggest/off) — chạy TRƯỚC khi gắn')
+    .option('--include-off', 'Hiện cả tag cấm AI gắn (mặc định ẩn)')
+    .option('--json', 'In JSON đầy đủ thay vì bảng gọn')
+    .action(async (opts) => {
+    const config = await loadConfigFromEnv();
+    const data = await cliGet(config, '/api/cli/tags', {
+        includeOff: opts.includeOff ? 'true' : undefined,
+    });
+    if (opts.json)
+        printJson(data);
+    else
+        printTagCatalog(data);
+});
+tag
+    .command('show')
+    .description('Tag đang có của 1 hội thoại + đề xuất đang chờ duyệt')
+    .requiredOption('--conversation <conversationId>', 'ID hội thoại trong LALO')
+    .option('--json', 'In JSON đầy đủ')
+    .action(async (opts) => {
+    const config = await loadConfigFromEnv();
+    const data = await cliGet(config, `/api/cli/conversations/${opts.conversation}/tags`);
+    if (opts.json)
+        printJson(data);
+    else
+        printTagsOfTarget(data);
+});
+tag
+    .command('apply')
+    .description('Gắn tag sau khi đọc chat. Tag nhóm an toàn vào thẳng; tag trạng thái vào hàng chờ sale duyệt')
+    .requiredOption('--conversation <conversationId>', 'ID hội thoại trong LALO')
+    .requiredOption('--tag <name...>', 'Tên tag ĐÚNG như trong danh mục. Lặp lại --tag để gắn nhiều tag, tối đa 10.')
+    .option('--reason <text...>', 'Căn cứ rút từ hội thoại — người duyệt cần biết vì sao. Khớp theo thứ tự với --tag.')
+    .option('--source-message <id...>', 'ID tin nhắn làm bằng chứng. Khớp theo thứ tự với --tag.')
+    .option('--json', 'In JSON đầy đủ')
+    .action(async (opts) => {
+    const config = await loadConfigFromEnv();
+    const asList = (v) => (Array.isArray(v) ? v : v ? [String(v)] : []);
+    const reasons = asList(opts.reason);
+    const sources = asList(opts.sourceMessage);
+    const tags = asList(opts.tag).map((name, i) => ({
+        name,
+        reason: reasons[i],
+        sourceMessageId: sources[i],
+    }));
+    const data = await cliPost(config, `/api/cli/conversations/${opts.conversation}/tags`, { tags });
+    if (opts.json)
+        printJson(data);
+    else
+        printApplyTagsResult(data);
+});
+const comment = program
+    .command('comment')
+    .description('Bình luận nội bộ trên hội thoại — sale thấy cột phải khung chat. KHÔNG gửi Zalo.');
+comment
+    .command('list')
+    .description('Đọc bình luận nội bộ đang có trên 1 hội thoại. Chạy TRƯỚC khi ghi thêm để không trùng.')
+    .requiredOption('--conversation <conversationId>', 'ID hội thoại trong LALO (lấy từ `conv list`)')
+    .option('--json', 'In JSON đầy đủ')
+    .action(async (opts) => {
+    const config = await loadConfigFromEnv();
+    const data = await cliGet(config, `/api/cli/conversations/${opts.conversation}/comments`);
+    if (opts.json)
+        printJson(data);
+    else
+        printConversationComments(data);
+});
+comment
+    .command('add')
+    .description('Ghi THẲNG bình luận nội bộ vào hội thoại — ghi luôn, không gửi Zalo. Sale thấy cột phải.')
+    .requiredOption('--conversation <conversationId>', 'ID hội thoại trong LALO')
+    .requiredOption('--text <text>', 'Nội dung bình luận (≤5000 ký tự)')
+    .option('--reply-to <commentId>', 'Trả lời 1 bình luận gốc (1 cấp). Lấy id từ `comment list`.')
+    .option('--json', 'In JSON đầy đủ')
+    .action(async (opts) => {
+    const config = await loadConfigFromEnv();
+    const data = await cliPost(config, `/api/cli/conversations/${opts.conversation}/comments`, { body: opts.text, parentCommentId: opts.replyTo });
+    if (opts.json)
+        printJson(data);
+    else
+        printAddConversationComment(data);
+});
+const msg = program.command('msg').description('Gửi tin nhắn Zalo (qua LALO, có bước duyệt trước khi gửi thật)');
+msg
+    .command('send')
+    .description('Gửi tin nhắn text. Mặc định CHỈ XEM TRƯỚC, không gửi gì cả — phải chọn --test-to hoặc --confirm mới thật sự gửi. "Cloud của tôi" KHÔNG được Zalo hỗ trợ gửi qua API, dùng --test-to trỏ tới 1 hội thoại an toàn khác thay thế.')
+    .requiredOption('--conversation <conversationId>', 'ID hội thoại trong LALO (lấy từ `conv list`)')
+    .requiredOption('--text <text>', 'Nội dung tin nhắn')
+    .option('--test-to <conversationId>', 'Gửi THẬT nhưng sang 1 hội thoại test khác (cùng nick) — không tới người nhận thật. Hỏi người vận hành hội thoại nào an toàn để dùng, đừng tự đoán.')
+    .option('--confirm', 'Gửi THẬT tới đúng hội thoại — chỉ dùng khi người vận hành đã xác nhận muốn gửi')
+    .option('--json', 'In JSON đầy đủ')
+    .action(async (opts) => {
+    if (opts.testTo && opts.confirm) {
+        console.error('Lỗi: chỉ chọn 1 trong --test-to hoặc --confirm, không dùng cả hai cùng lúc.');
+        process.exitCode = 1;
+        return;
+    }
+    const mode = opts.confirm ? 'confirm' : opts.testTo ? 'test_to' : 'dry_run';
+    const config = await loadConfigFromEnv();
+    const data = await cliPost(config, `/api/cli/conversations/${opts.conversation}/send`, {
+        text: opts.text,
+        mode,
+        testToConversationId: opts.testTo,
+    });
+    if (opts.json)
+        printJson(data);
+    else
+        printSendResult(data);
+});
+msg
+    .command('draft')
+    .description('Đặt tin NHÁP vào hội thoại để người vận hành duyệt trong app. Không gửi gì cho khách. Dùng thay `msg send` khi muốn sale thấy và bấm gửi thay vì mày tự gửi.')
+    .requiredOption('--conversation <conversationId>', 'ID hội thoại trong LALO (lấy từ `conv list`)')
+    .requiredOption('--text <text>', 'Nội dung tin nháp')
+    .option('--label <label>', 'Ghi chú ngắn hiện trên thẻ nháp, vd "trả lời hỏi giá"')
+    .option('--json', 'In JSON đầy đủ')
+    .action(async (opts) => {
+    const config = await loadConfigFromEnv();
+    const data = await cliPost(config, `/api/cli/conversations/${opts.conversation}/draft`, {
+        content: opts.text,
+        label: opts.label,
+    });
+    if (opts.json)
+        printJson(data);
+    else
+        printDraftResult(data);
+});
+msg
+    .command('send-file')
+    .description('Gửi ảnh/video/file đính kèm (đọc file trên máy mày, upload qua LALO). Cùng luật xem trước/test-to/confirm như `msg send`.')
+    .requiredOption('--conversation <conversationId>', 'ID hội thoại trong LALO (lấy từ `conv list`)')
+    .requiredOption('--file <localPath>', 'Đường dẫn file trên máy mày (ảnh: jpg/png/webp/gif ≤100MB, video: mp4/mov/webm ≤500MB, file: pdf/doc/xls/zip... ≤1GB)')
+    .option('--caption <text>', 'Chú thích kèm theo (không áp dụng cho ảnh gửi nhiều tấm)')
+    .option('--test-to <conversationId>', 'Gửi THẬT nhưng sang 1 hội thoại test khác (cùng nick) — không tới người nhận thật. Hỏi người vận hành hội thoại nào an toàn để dùng, đừng tự đoán.')
+    .option('--confirm', 'Gửi THẬT tới đúng hội thoại — chỉ dùng khi người vận hành đã xác nhận muốn gửi')
+    .option('--json', 'In JSON đầy đủ')
+    .action(async (opts) => {
+    if (opts.testTo && opts.confirm) {
+        console.error('Lỗi: chỉ chọn 1 trong --test-to hoặc --confirm, không dùng cả hai cùng lúc.');
+        process.exitCode = 1;
+        return;
+    }
+    const mode = opts.confirm ? 'confirm' : opts.testTo ? 'test_to' : 'dry_run';
+    const config = await loadConfigFromEnv();
+    const data = await cliPostFile(config, `/api/cli/conversations/${opts.conversation}/send-attachment`, opts.file, {
+        mode,
+        testToConversationId: opts.testTo,
+        caption: opts.caption,
+    });
+    if (opts.json)
+        printJson(data);
+    else
+        printSendAttachmentResult(data);
+});
+program.parseAsync(process.argv).catch((err) => {
+    console.error(`Lỗi: ${err instanceof Error ? err.message : String(err)}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/output.js

@@ -0,0 +1,206 @@
+export function printJson(data) {
+    process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+}
+/** UTC ISO (từ backend) → giờ VN (Asia/Ho_Chi_Minh, +07) cho output đọc bằng mắt. --json vẫn giữ UTC. */
+function formatVnTime(iso) {
+    const parts = new Intl.DateTimeFormat('sv-SE', {
+        timeZone: 'Asia/Ho_Chi_Minh',
+        year: 'numeric', month: '2-digit', day: '2-digit',
+        hour: '2-digit', minute: '2-digit', hour12: false,
+    }).formatToParts(new Date(iso));
+    const get = (type) => parts.find((p) => p.type === type)?.value ?? '';
+    return `${get('day')}/${get('month')} ${get('hour')}:${get('minute')} +07`;
+}
+export function printThreadsTable(res) {
+    const threads = res.threads;
+    if (!threads.length) {
+        console.log('(không có hội thoại nào)');
+        return;
+    }
+    for (const t of threads) {
+        const label = t.threadType === 'group'
+            ? (t.groupName ?? '(nhóm chưa có tên)')
+            : (t.contact?.fullName ?? t.externalThreadId ?? t.id);
+        const badge = t.threadType === 'group' ? `group·${t.groupMembersCount ?? '?'} người` : 'dm';
+        const unread = t.unreadCount ? ` · ${t.unreadCount} chưa đọc` : '';
+        const time = t.lastMessageAt ? formatVnTime(t.lastMessageAt) : 'chưa có tin';
+        console.log(`${t.id}  [${badge}]  ${label}${unread}  (${time})`);
+    }
+    const shown = res.offset + threads.length;
+    console.log(`— ${res.offset + 1}-${shown} / ${res.total} hội thoại`);
+    if (res.hasMore) {
+        console.log(`⚠ CÒN ${res.total - shown} hội thoại chưa lấy. Trang tiếp: --offset ${shown}. Lấy hết 1 lần: --all.`);
+    }
+}
+function formatMessageLine(m) {
+    const who = m.senderName ?? m.senderType;
+    const quoteTag = m.quote ? '[trả lời] ' : '';
+    // preview đã xử lý mọi loại tin; link tải chỉ thêm cho ảnh/video/tệp vì đó là
+    // thứ người vận hành thật sự mở lại.
+    const href = m.attachment?.href ? ` ${m.attachment.href}` : '';
+    const body = m.preview || `[${m.contentType}]`;
+    return `${formatVnTime(m.sentAt)}  ${who}: ${quoteTag}${body}${href}`;
+}
+export function printScanResult(res) {
+    if (!res.messages.length) {
+        console.log('(không có tin nhắn nào trong khoảng thời gian này)');
+        return;
+    }
+    for (const m of res.messages) {
+        console.log(formatMessageLine(m));
+    }
+    const shown = res.offset + res.messages.length;
+    console.log(`— ${res.messages.length}/${res.totalInWindow} tin trong khung giờ`);
+    if (res.hasMore) {
+        console.log(`⚠ CÒN ${res.totalInWindow - shown} tin CŨ HƠN chưa lấy. Trang tiếp: --offset ${shown}. Lấy hết 1 lần: --all.`);
+    }
+}
+export function printSweepResult(res) {
+    if (!res.conversationCount) {
+        console.log(`(không có tin nhắn nào trong ${res.sinceHours} giờ qua)`);
+        return;
+    }
+    console.log(`${res.returned} tin · ${res.conversationCount} hội thoại · ${res.sinceHours} giờ qua\n`);
+    for (const c of res.conversations) {
+        const kind = c.threadType === 'group' ? 'nhóm' : 'khách';
+        const via = c.accountName ? ` · qua nick "${c.accountName}"` : '';
+        const unread = c.unreadCount ? ` · ${c.unreadCount} chưa đọc` : '';
+        console.log(`▸ [${kind}] ${c.label}${via} — ${c.messageCount} tin${unread}`);
+        console.log(`  (${c.conversationId})`);
+        for (const m of c.messages)
+            console.log(`  ${formatMessageLine(m)}`);
+        console.log('');
+    }
+    if (res.hasMore) {
+        console.log(`⚠ CHẠM TRẦN: chỉ lấy ${res.returned}/${res.totalInWindow} tin trong khung giờ — phần CŨ nhất bị bỏ.`);
+        console.log('  Tăng --limit (tối đa 2000), thu hẹp --since-hours, hoặc quét từng nick bằng --account.');
+    }
+}
+const POLICY_LABEL = {
+    auto: 'tự gắn được',
+    suggest: 'phải duyệt',
+    off: 'CẤM AI gắn',
+};
+export function printTagCatalog(res) {
+    if (!res.total) {
+        console.log('(org chưa có tag CRM nào)');
+        return;
+    }
+    let currentGroup;
+    for (const t of res.tags) {
+        if (t.group !== currentGroup) {
+            currentGroup = t.group;
+            console.log(`\n▸ ${currentGroup ?? '(không nhóm)'}`);
+        }
+        const emoji = t.emoji ? `${t.emoji} ` : '';
+        const zalo = t.managedByZalo ? ' · nhãn Zalo' : '';
+        console.log(`  ${emoji}${t.name}  [${POLICY_LABEL[t.aiPolicy] ?? t.aiPolicy}]${zalo}`);
+        if (t.description)
+            console.log(`      ${t.description}`);
+    }
+    console.log(`\n${res.total} tag khả dụng.`);
+}
+export function printTagsOfTarget(res) {
+    const kind = res.targetType === 'conversation' ? 'nhóm' : 'khách';
+    console.log(`Tag của ${kind} "${res.label}":`);
+    console.log(res.tags.length ? `  ${res.tags.join(' · ')}` : '  (chưa có tag nào)');
+    if (res.pendingSuggestions.length) {
+        console.log(`\n${res.pendingSuggestions.length} đề xuất đang chờ duyệt:`);
+        for (const s of res.pendingSuggestions)
+            console.log(`  ⏳ ${s.tagName} — ${s.reason}`);
+        console.log('  (sale duyệt trong app: hồ sơ khách › tag AI đề xuất)');
+    }
+}
+export function printApplyTagsResult(res) {
+    const kind = res.targetType === 'conversation' ? 'nhóm' : 'khách';
+    console.log(`${kind} "${res.label}":`);
+    if (res.applied.length)
+        console.log(`  ✓ Đã gắn thẳng: ${res.applied.join(' · ')}`);
+    if (res.suggested.length) {
+        console.log(`  ⏳ Chờ sale duyệt: ${res.suggested.map((s) => s.name).join(' · ')}`);
+    }
+    if (res.alreadyHad.length)
+        console.log(`  = Đã có sẵn, bỏ qua: ${res.alreadyHad.join(' · ')}`);
+    for (const r of res.rejected)
+        console.log(`  ✗ Từ chối "${r.name}" — ${r.why}`);
+    if (!res.applied.length && !res.suggested.length)
+        return;
+    console.log(`  Tag hiện tại: ${res.tags.join(' · ') || '(trống)'}`);
+}
+export function printSendResult(res) {
+    if (res.mode === 'dry_run') {
+        console.log(`[XEM TRƯỚC — CHƯA GỬI] tới "${res.target.label}": "${res.text ?? ''}"`);
+        console.log('Muốn gửi thử sang hội thoại khác: thêm --test-to <conversationId>. Muốn gửi thật: thêm --confirm.');
+        return;
+    }
+    if (res.mode === 'test_to') {
+        console.log(`✓ Đã gửi THỬ tới "${res.testTarget?.label ?? '(hội thoại test)'}" — CHƯA gửi tới "${res.target.label}".`);
+        console.log('Ưng nội dung rồi thì chạy lại với --confirm để gửi thật.');
+        return;
+    }
+    console.log(`✓ Đã gửi THẬT tới "${res.target.label}"${res.zaloMsgId ? ` (msgId=${res.zaloMsgId})` : ''}.`);
+}
+export function printSendAttachmentResult(res) {
+    if (res.mode === 'dry_run') {
+        console.log(`[XEM TRƯỚC — CHƯA GỬI] ${res.kind} tới "${res.target.label}"`);
+        console.log('Muốn gửi thử sang hội thoại khác: thêm --test-to <conversationId>. Muốn gửi thật: thêm --confirm.');
+        return;
+    }
+    if (res.mode === 'test_to') {
+        console.log(`✓ Đã gửi THỬ (${res.kind}) tới "${res.testTarget?.label ?? '(hội thoại test)'}" — CHƯA gửi tới "${res.target.label}".`);
+        console.log('Ưng rồi thì chạy lại với --confirm để gửi thật.');
+        return;
+    }
+    console.log(`✓ Đã gửi THẬT (${res.kind}) tới "${res.target.label}"${res.zaloMsgId ? ` (msgId=${res.zaloMsgId})` : ''}.`);
+}
+export function printContactFacts(res) {
+    const who = res.contactName || '(chưa có tên)';
+    if (!res.facts.length) {
+        console.log(`Chưa có ghi nhớ nào về "${who}".`);
+        return;
+    }
+    console.log(`${res.facts.length} ghi nhớ về "${who}":`);
+    for (const f of res.facts) {
+        console.log(`  ${f.source === 'ai' ? '[AI]  ' : '[Người]'} ${f.text}`);
+    }
+}
+export function printWriteContactFacts(res) {
+    const who = res.contactName || '(chưa có tên)';
+    if (!res.written) {
+        console.log(`Không ghi gì mới về "${who}" — ${res.skippedDuplicates} câu đã có sẵn trong hồ sơ.`);
+        return;
+    }
+    console.log(`✓ Đã ghi ${res.written} ghi nhớ vào hồ sơ "${who}":`);
+    for (const f of res.facts)
+        console.log(`  + ${f.text}`);
+    if (res.skippedDuplicates)
+        console.log(`  (bỏ qua ${res.skippedDuplicates} câu đã có sẵn)`);
+    console.log('Xem lại/hoàn tác trong LALO > hồ sơ khách > Sự thật về người này > Lịch sử.');
+}
+export function printDraftResult(res) {
+    console.log(`Đã đặt nháp vào hội thoại${res.threadName ? ` "${res.threadName}"` : ''}.`);
+    console.log(`  ${res.content}`);
+    console.log('Nháp KHÔNG tự gửi — người vận hành mở chat, bấm "Duyệt & gửi" mới tới khách.');
+}
+function printCommentLine(c, indent = '') {
+    console.log(`${indent}${formatVnTime(c.createdAt)}  ${c.authorName}: ${c.body}`);
+    console.log(`${indent}  (${c.id})`);
+    for (const r of c.replies || [])
+        printCommentLine(r, `${indent}  `);
+}
+export function printConversationComments(res) {
+    if (!res.total) {
+        console.log(`Chưa có bình luận nội bộ nào trên "${res.label}".`);
+        return;
+    }
+    console.log(`${res.total} bình luận nội bộ trên "${res.label}" (không gửi Zalo):`);
+    for (const c of res.comments)
+        printCommentLine(c);
+}
+export function printAddConversationComment(res) {
+    const kind = res.comment.parentId ? 'trả lời' : 'bình luận';
+    console.log(`✓ Đã ghi ${kind} nội bộ vào "${res.label}". Khách Zalo KHÔNG nhận tin này.`);
+    console.log(`  ${res.comment.body}`);
+    console.log('Sale thấy ở cột phải khung chat (Bình luận hội thoại).');
+}
+//# sourceMappingURL=output.js.map

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "lalo-cli",
+  "version": "0.2.0",
+  "private": false,
+  "license": "Apache-2.0",
+  "description": "LALO CLI — đọc hội thoại Zalo, ghi hồ sơ, bình luận nội bộ và gửi tin (có duyệt) qua LALO. Không tự đăng nhập Zalo.",
+  "type": "module",
+  "bin": {
+    "lalo": "dist/index.js",
+    "zalocrm-cli": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist/**/*.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "test": "tsx --test test/config.test.ts",
+    "pack:check": "npm pack --dry-run"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@zalocrm/contracts": "file:../shared/contracts",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
+  }
+}