openzca 0.1.49 → 0.1.50

package/README.md

@@ -40,6 +40,12 @@ openzca msg send GROUP_ID "Hello team" --group
 openzca msg send GROUP_ID "Hi @Alice Nguyen" --group
 openzca msg send GROUP_ID "Hi @123456789" --group
 
+# Reply using a stored DB message id
+openzca msg send USER_ID "Reply text" --reply-id MSG_ID
+
+# Reply without DB using a listen --raw payload
+openzca msg send USER_ID "Reply text" --reply-message '{"threadId":"...","msgId":"...","cliMsgId":"...","content":"...","msgType":"webchat","senderId":"...","toId":"...","ts":"..."}'
+
 # Listen for incoming messages
 openzca listen
 
@@ -91,7 +97,7 @@ You can also open the saved file manually (for example: `open qr.png` on macOS).
 
 | Command | Description |
 |---------|-------------|
-| `openzca msg send <threadId> <message>` | Send text with formatting (`**bold**`, `*italic*`, `~~strike~~`, etc.) and group @mention resolution (`--raw` to skip formatting) |
+| `openzca msg send <threadId> <message>` | Send text with formatting (`**bold**`, `*italic*`, `~~strike~~`, etc.), group @mention resolution (`--raw` to skip formatting), and quote replies via `--reply-id` or `--reply-message` |
 | `openzca msg image <threadId> [file]` | Send image(s) from file or URL |
 | `openzca msg video <threadId> [file]` | Send video(s) from file or URL; single `.mp4` inputs try native video mode |
 | `openzca msg voice <threadId> [file]` | Send voice message from local file or URL (`.aac`, `.mp3`, `.m4a`, `.wav`, `.ogg`) |
@@ -115,6 +121,11 @@ Media commands accept local files, `file://` paths, and repeatable `--url` optio
 `openzca msg video` attempts native video send for a single `.mp4` input by uploading the video and thumbnail to Zalo first. If `ffmpeg` is unavailable, the input is not a single `.mp4`, or native send fails, it falls back to the normal attachment send path. Use `--thumbnail <path-or-url>` to supply the preview image explicitly.
 Local paths using `~` are expanded automatically (for positional file args, `--url`, and `OPENZCA_LISTEN_MEDIA_DIR`).
 Group text sends via `openzca msg send --group` resolve unique `@Name` or `@userId` mentions against the current group member list using member ids, display names, and usernames. Mention offsets are computed after formatting markers are parsed, so messages like `**@Alice Nguyen** hello` work. If multiple members share the same label, the command fails instead of guessing.
+Reply flows:
+
+- `--reply-id <id>` resolves a stored message from the local DB by `msgId`, `cliMsgId`, or internal message uid. This requires DB persistence to be enabled for the profile.
+- `--reply-message <json>` accepts either the original `message.data` object from `zca-js` or the current `openzca listen --raw` payload. Use this path when DB is disabled or when a caller already has the inbound payload in memory.
+- Use exactly one of `--reply-id` or `--reply-message`.
 `msg recent` keeps the previous live behavior by default. Use `--source db` to read only from the local SQLite store, or `--source auto` to try DB first and fall back to live history.
 
 ### Debug Logging

package/dist/cli.js

@@ -16,7 +16,7 @@ import {
   Gender,
   Reactions,
   ReviewPendingMemberRequestStatus,
-  ThreadType as ThreadType2
+  ThreadType as ThreadType3
 } from "zca-js";
 
 // src/lib/store.ts
@@ -2494,6 +2494,231 @@ async function sendNativeVideo(params) {
   }
 }
 
+// src/lib/reply.ts
+import { ThreadType as ThreadType2 } from "zca-js";
+function prepareReplyMessage(value, params) {
+  const sourceRecord = asReplyMessageRecord(value);
+  const metadata = asOptionalReplyMessageRecord(sourceRecord.metadata);
+  const rawMessageRecord = asOptionalReplyMessageRecord(sourceRecord.rawMessage);
+  const rawPayloadRecord = asOptionalReplyMessageRecord(sourceRecord.rawPayload);
+  const canonicalRecord = rawMessageRecord ?? sourceRecord;
+  const content = parseReplyMessageContent(
+    canonicalRecord.content ?? sourceRecord.content,
+    isLikelyOpenzcaListenPayload(sourceRecord) && !rawMessageRecord
+  );
+  const msgType = requireStringLike(
+    [canonicalRecord.msgType, sourceRecord.msgType, metadata?.msgType],
+    "reply message msgType"
+  );
+  const uidFrom = requireStringLike(
+    [
+      canonicalRecord.uidFrom,
+      sourceRecord.uidFrom,
+      sourceRecord.senderId,
+      sourceRecord.fromId,
+      metadata?.senderId,
+      metadata?.fromId
+    ],
+    "reply message uidFrom"
+  );
+  const msgId = requireStringLike(
+    [canonicalRecord.msgId, sourceRecord.msgId, rawPayloadRecord?.msgId],
+    "reply message msgId"
+  );
+  const cliMsgId = requireStringLike(
+    [canonicalRecord.cliMsgId, sourceRecord.cliMsgId, rawPayloadRecord?.cliMsgId],
+    "reply message cliMsgId"
+  );
+  const ts = requireTsString(
+    [canonicalRecord.ts, sourceRecord.ts, maybeTimestampSecondsToMsString(sourceRecord.timestamp)],
+    "reply message ts"
+  );
+  const ttl = parseReplyMessageTtl(canonicalRecord.ttl ?? sourceRecord.ttl);
+  const propertyExt = parseReplyMessagePropertyExt(canonicalRecord.propertyExt);
+  return {
+    quote: {
+      content,
+      msgType,
+      propertyExt,
+      uidFrom,
+      msgId,
+      cliMsgId,
+      ts,
+      ttl
+    },
+    inferredThreadId: inferReplyMessageThreadId({
+      sourceRecord,
+      canonicalRecord,
+      metadata,
+      threadType: params?.threadType,
+      selfId: params?.selfId
+    })
+  };
+}
+function prepareStoredReplyMessage(value, params) {
+  const record = asReplyMessageRecord(value);
+  const storedThreadType = record.threadType === "group" ? ThreadType2.Group : record.threadType === "user" ? ThreadType2.User : void 0;
+  if (storedThreadType !== void 0 && storedThreadType !== params.threadType) {
+    throw new Error("Reply source thread type does not match --group.");
+  }
+  const storedThreadId = firstString([record.threadId, record.rawThreadId]) ?? void 0;
+  if (storedThreadId && storedThreadId !== params.threadId) {
+    throw new Error("Reply source belongs to a different thread.");
+  }
+  const rawMessage = asOptionalReplyMessageRecord(record.rawMessage);
+  const rawPayload = asOptionalReplyMessageRecord(record.rawPayload);
+  const replyRecord = rawMessage ?? rawPayload;
+  if (!replyRecord) {
+    throw new Error(
+      "Reply source found in DB but has no reusable raw message payload. Re-sync or capture it via listener first."
+    );
+  }
+  return prepareReplyMessage(replyRecord, {
+    threadType: params.threadType,
+    selfId: params.selfId
+  }).quote;
+}
+function asReplyMessageRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("Reply message must be a JSON object matching the raw message.data shape.");
+  }
+  return value;
+}
+function asOptionalReplyMessageRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  return value;
+}
+function parseReplyMessageContent(value, stripOpenzcaDecorations) {
+  if (typeof value === "string") {
+    return stripOpenzcaDecorations ? stripEnrichedReplyDecorations(value) : value;
+  }
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  throw new Error("Reply message content must be a string or object.");
+}
+function stripEnrichedReplyDecorations(value) {
+  const lines = value.split("\n");
+  while (lines.length > 0) {
+    const last = lines[lines.length - 1].trim();
+    if (last.startsWith("[reply context: ") || last.startsWith("[reply media attached:") || last.startsWith("[reply media attached ")) {
+      lines.pop();
+      continue;
+    }
+    break;
+  }
+  return lines.join("\n");
+}
+function parseReplyMessagePropertyExt(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("Reply message propertyExt must be an object when provided.");
+  }
+  return value;
+}
+function parseReplyMessageTtl(value) {
+  if (value === void 0 || value === null || value === "") {
+    return 0;
+  }
+  const parsed = typeof value === "number" ? value : typeof value === "string" ? Number(value) : Number.NaN;
+  if (!Number.isFinite(parsed)) {
+    throw new Error("Reply message ttl must be a finite number.");
+  }
+  return Math.trunc(parsed);
+}
+function requireStringLike(values, label) {
+  const value = firstString(values);
+  if (!value) {
+    throw new Error(`Missing ${label}.`);
+  }
+  return value;
+}
+function requireTsString(values, label) {
+  for (const value of values) {
+    if (typeof value === "string" && value.trim()) {
+      return value.trim();
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+      return String(Math.trunc(value));
+    }
+  }
+  throw new Error(`Missing ${label}.`);
+}
+function firstString(values) {
+  for (const value of values) {
+    if (typeof value === "string" && value.trim()) {
+      return value.trim();
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+      return String(Math.trunc(value));
+    }
+  }
+  return void 0;
+}
+function maybeTimestampSecondsToMsString(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    return void 0;
+  }
+  return String(Math.trunc(value * 1e3));
+}
+function isLikelyOpenzcaListenPayload(record) {
+  return typeof record.threadId === "string" && (typeof record.senderId === "string" || typeof record.chatType === "string" || typeof record.metadata === "object");
+}
+function inferReplyMessageThreadId(params) {
+  const directThreadId = firstString([
+    params.sourceRecord.threadId,
+    params.sourceRecord.targetId,
+    params.sourceRecord.conversationId,
+    params.metadata?.threadId,
+    params.metadata?.targetId
+  ]);
+  if (directThreadId) {
+    return directThreadId;
+  }
+  if (params.threadType === void 0) {
+    return void 0;
+  }
+  const idTo = firstString([
+    params.canonicalRecord.idTo,
+    params.sourceRecord.idTo,
+    params.sourceRecord.toId,
+    params.metadata?.toId
+  ]);
+  if (params.threadType === ThreadType2.Group) {
+    return idTo;
+  }
+  const uidFrom = firstString([
+    params.canonicalRecord.uidFrom,
+    params.sourceRecord.uidFrom,
+    params.sourceRecord.senderId,
+    params.sourceRecord.fromId,
+    params.metadata?.senderId,
+    params.metadata?.fromId
+  ]);
+  if (!uidFrom && !idTo) {
+    return void 0;
+  }
+  if (params.selfId) {
+    if (uidFrom && uidFrom !== params.selfId && uidFrom !== "0") {
+      return uidFrom;
+    }
+    if (idTo && idTo !== params.selfId && idTo !== "0") {
+      return idTo;
+    }
+  }
+  if (uidFrom && uidFrom !== "0") {
+    return uidFrom;
+  }
+  if (idTo && idTo !== "0") {
+    return idTo;
+  }
+  return void 0;
+}
+
 // src/cli.ts
 var require2 = createRequire(import.meta.url);
 var { version: PKG_VERSION } = require2("../package.json");
@@ -2656,7 +2881,7 @@ function normalizeCommandAliases(argv) {
   return normalized;
 }
 function asThreadType(groupFlag) {
-  return groupFlag ? ThreadType2.Group : ThreadType2.User;
+  return groupFlag ? ThreadType3.Group : ThreadType3.User;
 }
 function parseBooleanFromEnv(name, fallback) {
   const raw = process.env[name]?.trim();
@@ -2866,7 +3091,7 @@ async function startListenerIpcServer(api, profile, sessionId, command) {
         fail(parsed.requestId, "Invalid upload payload.");
         return;
       }
-      const threadType = parsed.threadType === "group" ? ThreadType2.Group : ThreadType2.User;
+      const threadType = parsed.threadType === "group" ? ThreadType3.Group : ThreadType3.User;
       const requestTimeoutMs = parsePositiveIntFromUnknown(parsed.uploadTimeoutMs) ?? uploadTimeoutMs;
       writeDebugLine(
         "listen.ipc.upload.start",
@@ -3023,7 +3248,7 @@ async function tryUploadViaListenerIpc(profile, threadId, threadType, attachment
     {
       profile,
       threadId,
-      threadType: threadType === ThreadType2.Group ? "group" : "user",
+      threadType: threadType === ThreadType3.Group ? "group" : "user",
       attachmentCount: attachments.length,
       socketPath,
       requestId,
@@ -3067,7 +3292,7 @@ async function tryUploadViaListenerIpc(profile, threadId, threadType, attachment
         requestId,
         profile,
         threadId,
-        threadType: threadType === ThreadType2.Group ? "group" : "user",
+        threadType: threadType === ThreadType3.Group ? "group" : "user",
         attachments
       };
       socket.write(`${JSON.stringify(payload)}
@@ -3129,21 +3354,21 @@ async function tryUploadViaListenerIpc(profile, threadId, threadType, attachment
 }
 async function resolveUploadThreadType(api, profile, threadId, groupFlag, command) {
   if (groupFlag) {
-    return { type: ThreadType2.Group, reason: "explicit_group_flag" };
+    return { type: ThreadType3.Group, reason: "explicit_group_flag" };
   }
   const autoDetectEnabled = parseBooleanFromEnv("OPENZCA_UPLOAD_AUTO_THREAD_TYPE", false);
   if (!autoDetectEnabled) {
-    return { type: ThreadType2.User, reason: "auto_detect_disabled" };
+    return { type: ThreadType3.User, reason: "auto_detect_disabled" };
   }
   try {
     const cache = await readCache(profile);
     const groupIds = collectIdsFromCacheEntries(cache.groups, ["groupId", "grid", "threadId", "id"]);
     if (groupIds.has(threadId)) {
-      return { type: ThreadType2.Group, reason: "cache_group_match" };
+      return { type: ThreadType3.Group, reason: "cache_group_match" };
     }
     const friendIds = collectIdsFromCacheEntries(cache.friends, ["userId", "uid", "id", "threadId"]);
     if (friendIds.has(threadId)) {
-      return { type: ThreadType2.User, reason: "cache_friend_match" };
+      return { type: ThreadType3.User, reason: "cache_friend_match" };
     }
   } catch (error) {
     writeDebugLine(
@@ -3158,7 +3383,7 @@ async function resolveUploadThreadType(api, profile, threadId, groupFlag, comman
   }
   const probeEnabled = parseBooleanFromEnv("OPENZCA_UPLOAD_GROUP_PROBE", true);
   if (!probeEnabled) {
-    return { type: ThreadType2.User, reason: "probe_disabled" };
+    return { type: ThreadType3.User, reason: "probe_disabled" };
   }
   const probeTimeoutMs = parsePositiveIntFromEnv("OPENZCA_UPLOAD_GROUP_PROBE_TIMEOUT_MS", 5e3);
   try {
@@ -3168,7 +3393,7 @@ async function resolveUploadThreadType(api, profile, threadId, groupFlag, comman
       `Timed out waiting ${probeTimeoutMs}ms while probing group thread type.`
     );
     if (groupInfo?.gridInfoMap?.[threadId]) {
-      return { type: ThreadType2.Group, reason: "probe_group_match" };
+      return { type: ThreadType3.Group, reason: "probe_group_match" };
     }
   } catch (error) {
     writeDebugLine(
@@ -3181,7 +3406,7 @@ async function resolveUploadThreadType(api, profile, threadId, groupFlag, comman
       command
     );
   }
-  return { type: ThreadType2.User, reason: "default_user" };
+  return { type: ThreadType3.User, reason: "default_user" };
 }
 function parseReaction(input) {
   const normalized = input.trim();
@@ -3279,6 +3504,62 @@ async function shouldWriteToDb(profile, override) {
   }
   return isDbEnabled(profile);
 }
+async function resolveSendReplyQuote(params) {
+  const replyId = params.replyId?.trim();
+  const replyMessage = params.replyMessage?.trim();
+  if (replyId && replyMessage) {
+    throw new Error("Use either --reply-id or --reply-message, not both.");
+  }
+  if (!replyId && !replyMessage) {
+    return void 0;
+  }
+  if (replyId) {
+    if (!await shouldWriteToDb(params.profile)) {
+      throw new Error("`--reply-id` requires the local DB. Enable DB/listen sync first.");
+    }
+    const row = await getMessageById({
+      profile: params.profile,
+      id: replyId
+    });
+    if (!row) {
+      throw new Error(`Reply source not found in DB: ${replyId}`);
+    }
+    if (row.threadType === "group" !== (params.threadType === ThreadType3.Group)) {
+      throw new Error("Reply source thread type does not match --group.");
+    }
+    if (row.threadId !== params.threadId) {
+      throw new Error("Reply source belongs to a different thread.");
+    }
+    if (!row.rawMessage || typeof row.rawMessage !== "object") {
+      if (!row.rawPayload || typeof row.rawPayload !== "object") {
+        throw new Error(
+          "Reply source found in DB but has no reusable raw message payload. Re-sync or capture it via listener first."
+        );
+      }
+    }
+    return prepareStoredReplyMessage(row, {
+      threadId: params.threadId,
+      threadType: params.threadType,
+      selfId: params.api.getOwnId()
+    });
+  }
+  let parsedReplyMessage;
+  try {
+    parsedReplyMessage = JSON.parse(replyMessage);
+  } catch (error) {
+    throw new Error(
+      `Invalid JSON for --reply-message: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  const preparedReply = prepareReplyMessage(parsedReplyMessage, {
+    threadType: params.threadType,
+    selfId: params.api.getOwnId()
+  });
+  if (preparedReply.inferredThreadId && preparedReply.inferredThreadId !== params.threadId) {
+    throw new Error("Reply message belongs to a different thread.");
+  }
+  return preparedReply.quote;
+}
 function scheduleDbWrite(profile, command, event, task) {
   enqueueDbWrite(profile, async () => {
     try {
@@ -4259,7 +4540,7 @@ function normalizeGroupHistoryMessages(messages, fallbackThreadId) {
     const threadIdRaw = String(raw.idTo ?? "").trim();
     normalized.push({
       threadId: threadIdRaw || fallbackThreadId,
-      type: ThreadType2.Group,
+      type: ThreadType3.Group,
       data: {
         actionId: typeof raw.actionId === "string" && raw.actionId.trim() ? raw.actionId : void 0,
         msgId: String(raw.msgId ?? ""),
@@ -4364,7 +4645,7 @@ async function crawlGroupHistoryViaListener(api, options) {
         requestedCursors.add(cursor);
       }
       pagesRequested += 1;
-      api.listener.requestOldMessages(ThreadType2.Group, cursor || null);
+      api.listener.requestOldMessages(ThreadType3.Group, cursor || null);
       return true;
     };
     const armIdleTimer = () => {
@@ -4419,7 +4700,7 @@ async function crawlGroupHistoryViaListener(api, options) {
       }
     };
     const onOldMessages = (messages, type) => {
-      if (type !== ThreadType2.Group) return;
+      if (type !== ThreadType3.Group) return;
       armIdleTimer();
       const typedMessages = messages;
       processing = processing.then(async () => {
@@ -4508,7 +4789,7 @@ async function fetchRecentUserMessagesViaListener(api, threadId, count) {
         requestedCursors.add(cursor);
       }
       pagesRequested += 1;
-      api.listener.requestOldMessages(ThreadType2.User, cursor || null);
+      api.listener.requestOldMessages(ThreadType3.User, cursor || null);
       return true;
     };
     const cleanup = () => {
@@ -4540,7 +4821,7 @@ async function fetchRecentUserMessagesViaListener(api, threadId, count) {
       }
     };
     const onOldMessages = (messages, type) => {
-      if (type !== ThreadType2.User) return;
+      if (type !== ThreadType3.User) return;
       const typedMessages = messages;
       for (const message of typedMessages) {
         if (message.threadId === threadId) {
@@ -4616,7 +4897,7 @@ async function fetchRecentUserMessagesAcrossThreads(api, maxMessages) {
         requestedCursors.add(cursor);
       }
       pagesRequested += 1;
-      api.listener.requestOldMessages(ThreadType2.User, cursor || null);
+      api.listener.requestOldMessages(ThreadType3.User, cursor || null);
       return true;
     };
     const cleanup = () => {
@@ -4648,7 +4929,7 @@ async function fetchRecentUserMessagesAcrossThreads(api, maxMessages) {
       }
     };
     const onOldMessages = (messages, type) => {
-      if (type !== ThreadType2.User) return;
+      if (type !== ThreadType3.User) return;
       const typedMessages = messages;
       for (const message of typedMessages) {
         const key = toKey(message);
@@ -4731,7 +5012,7 @@ function toDbRecordFromRecentMessage(params) {
   const quote = params.message.data?.quote;
   return normalizeInboundListenRecord({
     profile: params.profile,
-    threadType: params.message.type === ThreadType2.Group ? "group" : "user",
+    threadType: params.message.type === ThreadType3.Group ? "group" : "user",
     rawThreadId: params.message.threadId,
     senderId: params.message.data?.uidFrom,
     senderName: params.message.data?.dName,
@@ -6083,17 +6364,29 @@ dbSync.command("chat <chatId>").option("-n, --count <count>", "Recent messages t
   })
 );
 var msg = program.command("msg").description("Messaging commands");
-msg.command("send <threadId> <message>").option("-g, --group", "Send to group").option("--raw", "Send raw text without parsing formatting markers").description("Send text message with formatting (**bold** *italic* __bold__ ~~strike~~ {underline}text{/underline} {red}color{/red} {big}size{/big} lists indents). Group sends also resolve unique @Name/@userId mentions.").action(
+msg.command("send <threadId> <message>").option("-g, --group", "Send to group").option("--raw", "Send raw text without parsing formatting markers").option("--reply-id <id>", "Reply using a stored DB message id/msgId/cliMsgId").option("--reply-message <json>", "Reply using a raw message.data JSON object").description("Send text message with formatting (**bold** *italic* __bold__ ~~strike~~ {underline}text{/underline} {red}color{/red} {big}size{/big} lists indents). Group sends also resolve unique @Name/@userId mentions.").action(
   wrapAction(async (threadId, message, opts, command) => {
     const { api, profile } = await requireApi(command);
     const threadType = asThreadType(opts.group);
-    const payload = await buildTextSendPayload({
+    const textPayload = await buildTextSendPayload({
       message,
       raw: opts.raw,
       threadType,
       threadId,
-      listGroupMembers: threadType === ThreadType2.Group ? (groupId) => listGroupMentionMembers(api, groupId) : void 0
+      listGroupMembers: threadType === ThreadType3.Group ? (groupId) => listGroupMentionMembers(api, groupId) : void 0
+    });
+    const quote = await resolveSendReplyQuote({
+      profile,
+      api,
+      threadId,
+      threadType,
+      replyId: opts.replyId,
+      replyMessage: opts.replyMessage
     });
+    const payload = quote || typeof textPayload !== "string" ? {
+      ...typeof textPayload === "string" ? { msg: textPayload } : textPayload,
+      ...quote ? { quote } : {}
+    } : textPayload;
     const response = await api.sendMessage(payload, threadId, threadType);
     output(response, false);
     if (await shouldWriteToDb(profile)) {
@@ -6582,8 +6875,8 @@ msg.command("upload <arg1> [arg2]").option("-u, --url <url>", "File URL (repeata
         {
           threadId,
           explicitGroupFlag: Boolean(opts.group),
-          isGroup: threadResolution.type === ThreadType2.Group,
-          threadType: threadResolution.type === ThreadType2.Group ? "group" : "user",
+          isGroup: threadResolution.type === ThreadType3.Group,
+          threadType: threadResolution.type === ThreadType3.Group ? "group" : "user",
           threadTypeReason: threadResolution.reason,
           localFiles,
           urlInputs
@@ -6611,7 +6904,7 @@ msg.command("upload <arg1> [arg2]").option("-u, --url <url>", "File URL (repeata
             "msg.upload.ipc.done",
             {
               threadId,
-              threadType: threadResolution.type === ThreadType2.Group ? "group" : "user"
+              threadType: threadResolution.type === ThreadType3.Group ? "group" : "user"
             },
             command
           );
@@ -6622,7 +6915,7 @@ msg.command("upload <arg1> [arg2]").option("-u, --url <url>", "File URL (repeata
           "msg.upload.ipc.fallback",
           {
             threadId,
-            threadType: threadResolution.type === ThreadType2.Group ? "group" : "user",
+            threadType: threadResolution.type === ThreadType3.Group ? "group" : "user",
             reason: ipcResult.reason
           },
           command
@@ -6661,7 +6954,7 @@ msg.command("recent <threadId>").option("-g, --group", "List recent messages for
       const { api, profile } = await requireApi(command);
       const parsedCount = Number(opts.count);
       const count = Number.isFinite(parsedCount) ? Math.min(Math.max(Math.trunc(parsedCount), 1), 200) : 20;
-      const threadType = opts.group ? ThreadType2.Group : ThreadType2.User;
+      const threadType = opts.group ? ThreadType3.Group : ThreadType3.User;
       const source = (opts.source ?? "live").trim().toLowerCase();
       if (!["live", "db", "auto"].includes(source)) {
         throw new Error("--source must be one of: live, db, auto");
@@ -6682,7 +6975,7 @@ msg.command("recent <threadId>").option("-g, --group", "List recent messages for
           msgId: message.data.msgId,
           cliMsgId: message.data.cliMsgId,
           threadId: message.threadId || threadId,
-          threadType: message.type === ThreadType2.Group ? "group" : "user",
+          threadType: message.type === ThreadType3.Group ? "group" : "user",
           senderId: message.data.uidFrom,
           senderName: message.data.dName ?? "",
           ts: message.data.ts,
@@ -6691,7 +6984,7 @@ msg.command("recent <threadId>").option("-g, --group", "List recent messages for
             msgId: message.data.msgId,
             cliMsgId: message.data.cliMsgId,
             threadId: message.threadId || threadId,
-            group: message.type === ThreadType2.Group
+            group: message.type === ThreadType3.Group
           },
           content: typeof message.data.content === "string" ? message.data.content : JSON.stringify(message.data.content)
         }));
@@ -6700,7 +6993,7 @@ msg.command("recent <threadId>").option("-g, --group", "List recent messages for
         output(
           {
             threadId,
-            threadType: threadType === ThreadType2.Group ? "group" : "user",
+            threadType: threadType === ThreadType3.Group ? "group" : "user",
             count: rows.length,
             messages: rows
           },
@@ -6720,7 +7013,7 @@ msg.command("pin <threadId>").option("-g, --group", "Pin group conversation").de
     output(
       {
         threadId,
-        threadType: type === ThreadType2.Group ? "group" : "user",
+        threadType: type === ThreadType3.Group ? "group" : "user",
         pinned: true,
         response
       },
@@ -6736,7 +7029,7 @@ msg.command("unpin <threadId>").option("-g, --group", "Unpin group conversation"
     output(
       {
         threadId,
-        threadType: type === ThreadType2.Group ? "group" : "user",
+        threadType: type === ThreadType3.Group ? "group" : "user",
         pinned: false,
         response
       },
@@ -7576,7 +7869,7 @@ ${replyMediaText}` : replyMediaText;
             processedText = processedText.trim() ? `${processedText}
 ${replyContextText}` : replyContextText;
           }
-          const chatType = message.type === ThreadType2.Group ? "group" : "user";
+          const chatType = message.type === ThreadType3.Group ? "group" : "user";
           const senderId = getStringCandidate(messageData, ["uidFrom"]) || message.data.uidFrom;
           const senderDisplayNameRaw = getStringCandidate(messageData, [
             "dName",
@@ -7585,7 +7878,7 @@ ${replyContextText}` : replyContextText;
             "displayName"
           ]);
           const senderDisplayName = senderDisplayNameRaw || void 0;
-          const senderNameForMetadata = message.type === ThreadType2.Group ? senderDisplayName : void 0;
+          const senderNameForMetadata = message.type === ThreadType3.Group ? senderDisplayName : void 0;
           const toId = getStringCandidate(messageData, ["idTo"]) || void 0;
           const threadName = typeof messageData.threadName === "string" ? messageData.threadName : typeof messageData.tName === "string" ? messageData.tName : void 0;
           const mentions = extractInboundMentions({
@@ -7623,7 +7916,7 @@ ${replyContextText}` : replyContextText;
             mentions: mentions.length > 0 ? mentions : void 0,
             mentionIds: mentionIds.length > 0 ? mentionIds : void 0,
             metadata: {
-              isGroup: message.type === ThreadType2.Group,
+              isGroup: message.type === ThreadType3.Group,
               chatType,
               threadId: message.threadId,
               targetId: message.threadId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openzca",
-  "version": "0.1.49",
+  "version": "0.1.50",
   "description": "Open-source zca-compatible CLI to integrate Zalo with OpenClaw",
   "type": "module",
   "bin": {