openzca 0.1.55 → 0.1.57

package/dist/cli.js

@@ -2824,6 +2824,72 @@ import fs5 from "fs/promises";
 import os3 from "os";
 import path5 from "path";
 import { promisify } from "util";
+
+// src/lib/send-retry.ts
+var DEFAULT_SEND_RETRY_COUNT = 1;
+var DEFAULT_SEND_RETRY_DELAY_MS = 750;
+var RETRYABLE_SEND_ERROR_PATTERNS = [
+  /retry limit/i,
+  /\btimeout\b/i,
+  /\btimed out\b/i,
+  /\betimedout\b/i,
+  /\beconnreset\b/i,
+  /\besockettimedout\b/i,
+  /\bsocket hang up\b/i,
+  /\btemporar(?:y|ily)\b/i
+];
+function sleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+function parsePositiveIntEnv(value, fallback) {
+  const raw = value?.trim();
+  if (!raw) return fallback;
+  if (raw === "0") return 0;
+  const parsed = Number.parseInt(raw, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function getSendRetryConfigFromEnv(env = process.env) {
+  return {
+    number: parsePositiveIntEnv(env.OPENZCA_SEND_RETRY_COUNT, DEFAULT_SEND_RETRY_COUNT),
+    delayMs: parsePositiveIntEnv(env.OPENZCA_SEND_RETRY_DELAY_MS, DEFAULT_SEND_RETRY_DELAY_MS)
+  };
+}
+function isRetryableSendError(error) {
+  const message = error instanceof Error ? error.message : String(error ?? "");
+  return RETRYABLE_SEND_ERROR_PATTERNS.some((pattern) => pattern.test(message));
+}
+function retryable(operation, options) {
+  const maxRetries = Math.max(0, options?.number ?? DEFAULT_SEND_RETRY_COUNT);
+  const delayMs = Math.max(0, options?.delayMs ?? DEFAULT_SEND_RETRY_DELAY_MS);
+  const shouldRetry = options?.on ?? isRetryableSendError;
+  return async (...args) => {
+    let attempt = 0;
+    while (true) {
+      try {
+        return await operation(...args);
+      } catch (error) {
+        attempt += 1;
+        if (attempt > maxRetries || !shouldRetry(error)) {
+          throw error;
+        }
+        await options?.onRetry?.({
+          attempt,
+          maxRetries,
+          delayMs,
+          error,
+          args
+        });
+        if (delayMs > 0) {
+          await sleep(delayMs);
+        }
+      }
+    }
+  };
+}
+
+// src/lib/video-send.ts
 var execFileAsync = promisify(execFile);
 function planVideoSendMode(params) {
   const { files, ffmpegAvailable } = params;
@@ -2982,7 +3048,8 @@ async function sendNativeVideo(params) {
   try {
     const uploadedVideo = await params.api.uploadAttachment([params.videoPath], params.threadId, params.threadType);
     const uploadedThumbnail = await params.api.uploadAttachment([thumbnailPath], params.threadId, params.threadType);
-    return await params.api.sendVideo(
+    const sendVideo = retryable(params.api.sendVideo.bind(params.api), getSendRetryConfigFromEnv());
+    return await sendVideo(
       {
         msg: params.message ?? "",
         videoUrl: pickUploadedVideoUrl(uploadedVideo[0]),
@@ -3224,6 +3291,125 @@ function inferReplyMessageThreadId(params) {
   return void 0;
 }
 
+// src/lib/adaptive-batch.ts
+var RETRYABLE_LOOKUP_ERROR_PATTERNS = [
+  /retry limit/i,
+  /\brate limit/i,
+  /\btoo many requests?\b/i,
+  /\btimeout\b/i,
+  /\btimed out\b/i,
+  /\betimedout\b/i,
+  /\beconnreset\b/i,
+  /\besockettimedout\b/i,
+  /\bsocket hang up\b/i,
+  /\btemporar(?:y|ily)\b/i
+];
+var SPLITTABLE_LOOKUP_ERROR_PATTERNS = [
+  /\binvalid param(?:eter)?s?\b/i,
+  /\binvalid request\b/i,
+  /\bbad request\b/i,
+  /tham so khong hop le/i,
+  /tham số không hợp lệ/i
+];
+function sleep2(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+function chunkKeys(keys, size) {
+  const chunkSize = Math.max(1, Math.trunc(size) || 1);
+  const chunks = [];
+  for (let index = 0; index < keys.length; index += chunkSize) {
+    chunks.push(keys.slice(index, index + chunkSize));
+  }
+  return chunks;
+}
+function toErrorText(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function isRetryableLookupError(error) {
+  const message = toErrorText(error);
+  return RETRYABLE_LOOKUP_ERROR_PATTERNS.some((pattern) => pattern.test(message));
+}
+function isSplittableLookupError(error) {
+  const message = toErrorText(error);
+  return SPLITTABLE_LOOKUP_ERROR_PATTERNS.some((pattern) => pattern.test(message));
+}
+async function runAdaptiveBatch(keys, options) {
+  const maxRetries = Math.max(0, options.maxRetries ?? 2);
+  const initialDelayMs = Math.max(0, options.retryDelayMs ?? 400);
+  const backoffMultiplier = Math.max(1, options.backoffMultiplier ?? 2);
+  const shouldRetry = options.shouldRetry ?? isRetryableLookupError;
+  const shouldSplit = options.shouldSplit ?? isSplittableLookupError;
+  let attempt = 0;
+  let delayMs = initialDelayMs;
+  while (true) {
+    try {
+      return await options.fetchBatch(keys) ?? {};
+    } catch (error) {
+      if (keys.length > 1 && shouldSplit(error)) {
+        throw error;
+      }
+      attempt += 1;
+      if (attempt > maxRetries || !shouldRetry(error)) {
+        throw error;
+      }
+      await options.onRetry?.({
+        keys: [...keys],
+        attempt,
+        maxRetries,
+        delayMs,
+        error
+      });
+      if (delayMs > 0) {
+        await sleep2(delayMs);
+      }
+      delayMs = Math.max(delayMs * backoffMultiplier, delayMs + 1);
+    }
+  }
+}
+async function fetchAdaptiveObjectBatches(keys, options) {
+  const uniqueKeys = Array.from(new Set(keys.map((value) => value.trim()).filter(Boolean)));
+  const pending = chunkKeys(uniqueKeys, options.initialBatchSize ?? 5);
+  const values = /* @__PURE__ */ new Map();
+  const errors = [];
+  const shouldRetry = options.shouldRetry ?? isRetryableLookupError;
+  const shouldSplit = options.shouldSplit ?? isSplittableLookupError;
+  const continueOnItemError = options.continueOnItemError ?? true;
+  const batchDelayMs = Math.max(0, options.batchDelayMs ?? 75);
+  while (pending.length > 0) {
+    const batch = pending.shift();
+    if (!batch || batch.length === 0) {
+      continue;
+    }
+    try {
+      const result = await runAdaptiveBatch(batch, options);
+      for (const key of batch) {
+        const value = result[key];
+        if (value !== void 0) {
+          values.set(key, value);
+        }
+      }
+    } catch (error) {
+      if (batch.length > 1 && (shouldSplit(error) || shouldRetry(error))) {
+        pending.unshift(...chunkKeys(batch, Math.ceil(batch.length / 2)));
+        continue;
+      }
+      if (!continueOnItemError || batch.length > 1) {
+        throw error;
+      }
+      const itemError = { key: batch[0], error };
+      errors.push(itemError);
+      await options.onItemError?.(itemError);
+      continue;
+    }
+    if (batchDelayMs > 0 && pending.length > 0) {
+      await sleep2(batchDelayMs);
+    }
+  }
+  return { values, errors };
+}
+
 // src/cli.ts
 var require3 = createRequire2(import.meta.url);
 var { version: PKG_VERSION } = require3("../package.json");
@@ -3446,6 +3632,63 @@ function parsePositiveIntFromUnknown(value) {
   }
   return null;
 }
+function retrySendMethod(operation, command, metaBuilder) {
+  const config = getSendRetryConfigFromEnv();
+  return retryable(operation, {
+    ...config,
+    onRetry: ({ attempt, maxRetries, delayMs, error, args }) => {
+      writeDebugLine(
+        "send.retry",
+        {
+          ...metaBuilder(...args),
+          attempt,
+          maxRetries,
+          delayMs,
+          message: error instanceof Error ? error.message : String(error)
+        },
+        command
+      );
+    }
+  });
+}
+var LOOKUP_BATCH_SIZE = 5;
+var LOOKUP_RETRY_COUNT = 2;
+var LOOKUP_RETRY_DELAY_MS = 400;
+var LOOKUP_BATCH_DELAY_MS = 75;
+async function fetchGroupInfoRecords(api, groupIds) {
+  const { values } = await fetchAdaptiveObjectBatches(groupIds, {
+    fetchBatch: async (keys) => {
+      const response = await api.getGroupInfo(keys);
+      return response.gridInfoMap ?? {};
+    },
+    initialBatchSize: LOOKUP_BATCH_SIZE,
+    maxRetries: LOOKUP_RETRY_COUNT,
+    retryDelayMs: LOOKUP_RETRY_DELAY_MS,
+    batchDelayMs: LOOKUP_BATCH_DELAY_MS
+  });
+  return values;
+}
+async function fetchGroupInfoRecord(api, groupId) {
+  const groups = await fetchGroupInfoRecords(api, [groupId]);
+  const group2 = groups.get(groupId);
+  if (!group2) {
+    throw new Error(`Group not found: ${groupId}`);
+  }
+  return group2;
+}
+async function fetchGroupMemberProfiles(api, memberIds) {
+  const { values } = await fetchAdaptiveObjectBatches(memberIds, {
+    fetchBatch: async (keys) => {
+      const response = await api.getGroupMembersInfo(keys);
+      return response.profiles ?? {};
+    },
+    initialBatchSize: LOOKUP_BATCH_SIZE,
+    maxRetries: LOOKUP_RETRY_COUNT,
+    retryDelayMs: LOOKUP_RETRY_DELAY_MS,
+    batchDelayMs: LOOKUP_BATCH_DELAY_MS
+  });
+  return values;
+}
 function isProcessAlive(pid) {
   if (!Number.isInteger(pid) || pid <= 0) return false;
   try {
@@ -3598,6 +3841,15 @@ async function startListenerIpcServer(api, profile, sessionId, command) {
       }
       const threadType = parsed.threadType === "group" ? ThreadType3.Group : ThreadType3.User;
       const requestTimeoutMs = parsePositiveIntFromUnknown(parsed.uploadTimeoutMs) ?? uploadTimeoutMs;
+      const sendMessage = retrySendMethod(
+        api.sendMessage.bind(api),
+        command,
+        (_payload, threadId, threadTypeArg) => ({
+          kind: "listen.ipc.upload",
+          threadId,
+          threadType: threadTypeArg === ThreadType3.Group ? "group" : "user"
+        })
+      );
       writeDebugLine(
         "listen.ipc.upload.start",
         {
@@ -3613,7 +3865,7 @@ async function startListenerIpcServer(api, profile, sessionId, command) {
       );
       try {
         const response = await withTimeout(
-          api.sendMessage(
+          sendMessage(
             {
               msg: "",
               attachments: parsed.attachments
@@ -3642,7 +3894,7 @@ async function startListenerIpcServer(api, profile, sessionId, command) {
           command
         );
       } catch (error) {
-        fail(parsed.requestId, toErrorText(error));
+        fail(parsed.requestId, toErrorText2(error));
         writeDebugLine(
           "listen.ipc.upload.error",
           {
@@ -3651,7 +3903,7 @@ async function startListenerIpcServer(api, profile, sessionId, command) {
             requestId: parsed.requestId,
             threadId: parsed.threadId,
             threadType: parsed.threadType,
-            message: toErrorText(error)
+            message: toErrorText2(error)
           },
           command
         );
@@ -3680,7 +3932,7 @@ async function startListenerIpcServer(api, profile, sessionId, command) {
         {
           profile,
           sessionId,
-          message: toErrorText(error)
+          message: toErrorText2(error)
         },
         command
       );
@@ -3692,7 +3944,7 @@ async function startListenerIpcServer(api, profile, sessionId, command) {
       {
         profile,
         sessionId,
-        message: toErrorText(error)
+        message: toErrorText2(error)
       },
       command
     );
@@ -3881,7 +4133,7 @@ async function resolveUploadThreadType(api, profile, threadId, groupFlag, comman
       {
         profile,
         threadId,
-        message: toErrorText(error)
+        message: toErrorText2(error)
       },
       command
     );
@@ -3906,7 +4158,7 @@ async function resolveUploadThreadType(api, profile, threadId, groupFlag, comman
       {
         profile,
         threadId,
-        message: toErrorText(error)
+        message: toErrorText2(error)
       },
       command
     );
@@ -4147,8 +4399,8 @@ async function persistOutgoingMessageBestEffort(params) {
     });
   }
 }
-async function persistGroupMembersSnapshot(profile, groupId, api) {
-  const rows = await listGroupMemberRows(api, groupId);
+async function persistGroupMembersSnapshot(profile, groupId, api, groupInfo) {
+  const rows = await listGroupMemberRows(api, groupId, groupInfo);
   const snapshotAtMs = Date.now();
   for (const row of rows) {
     await persistContact({
@@ -4353,7 +4605,15 @@ async function prepareDbGroupTarget(params) {
     isHidden: params.hiddenIds.has(params.groupId),
     rawJson: params.rawJson
   });
-  await persistGroupMembersSnapshot(params.profile, params.groupId, params.api);
+  if (params.hydrateMembers === false) {
+    return {};
+  }
+  try {
+    await persistGroupMembersSnapshot(params.profile, params.groupId, params.api, params.group);
+    return {};
+  } catch (error) {
+    return { memberSnapshotError: toErrorText2(error) };
+  }
 }
 function resolveContactDisplayName(params) {
   return params.displayName?.trim() || params.zaloName?.trim() || params.fallbackTitle?.trim() || params.userId.trim() || void 0;
@@ -4455,18 +4715,17 @@ async function hydrateUnknownLiveGroup(params) {
     }
   }
   if (group2 || title) {
-    await persistThread({
+    await prepareDbGroupTarget({
       profile: params.profile,
-      scopeThreadId: params.groupId,
-      rawThreadId: params.groupId,
-      threadType: "group",
+      api: params.api,
+      groupId: params.groupId,
+      group: group2,
       title,
-      rawJson: group2 ? JSON.stringify(group2) : void 0
+      rawJson: group2 ? JSON.stringify(group2) : void 0,
+      pinnedIds: /* @__PURE__ */ new Set(),
+      hiddenIds: /* @__PURE__ */ new Set(),
+      hydrateMembers: Boolean(group2)
     });
-    try {
-      await persistGroupMembersSnapshot(params.profile, params.groupId, params.api);
-    } catch {
-    }
     return;
   }
   if (params.fallbackTitle?.trim()) {
@@ -4536,16 +4795,23 @@ async function syncDbGroupHistoryFull(params) {
     pagesRequested = result.pagesRequested;
     listenerImportedCount = await getStoredGroupMessageCount() - beforeCount;
   } catch (error) {
-    stopReason = `fallback_window:${toErrorText(error)}`;
+    stopReason = `fallback_window:${toErrorText2(error)}`;
     completeness = "window";
   }
   const fallbackCount = 200;
   params.progress?.(`merging recent group API window (${fallbackCount} per group)`);
   const beforeApiCount = await getStoredGroupMessageCount();
+  const topoffErrors = [];
   for (const groupId of params.targetGroupIds) {
-    const messages = await fetchRecentGroupMessagesViaApi(params.api, groupId, fallbackCount);
-    await persistMessages(messages);
-    params.progress?.(`group ${groupId}: fetched ${messages.length} message(s) from group history API`);
+    try {
+      const messages = await fetchRecentGroupMessagesViaApi(params.api, groupId, fallbackCount);
+      await persistMessages(messages);
+      params.progress?.(`group ${groupId}: fetched ${messages.length} message(s) from group history API`);
+    } catch (error) {
+      const message = toErrorText2(error);
+      topoffErrors.push({ groupId, error: message });
+      params.progress?.(`group ${groupId}: group history API skipped (${message})`);
+    }
   }
   const afterCount = await getStoredGroupMessageCount();
   const apiAddedCount = afterCount - beforeApiCount;
@@ -4575,7 +4841,8 @@ async function syncDbGroupHistoryFull(params) {
     imported,
     completeness,
     stopReason,
-    pagesRequested
+    pagesRequested,
+    topoffErrors
   });
 }
 async function syncDbFriendDirectory(params) {
@@ -4712,25 +4979,70 @@ async function runDbSync(params) {
       });
     }
     if (params.mode === "all" || params.mode === "groups") {
-      const groups = await buildGroupsDetailed(api);
+      const groups = await api.getAllGroups();
+      const groupIds = Object.keys(groups.gridVerMap ?? {});
       const targetGroupIds = /* @__PURE__ */ new Set();
       const titleById = /* @__PURE__ */ new Map();
-      for (const group2 of groups) {
-        const record = group2;
-        const groupId = normalizeCachedId(record.groupId);
-        if (!groupId) continue;
-        const title = typeof record.name === "string" && record.name.trim() ? record.name.trim() : typeof record.groupName === "string" && record.groupName.trim() ? record.groupName.trim() : void 0;
-        targetGroupIds.add(groupId);
-        titleById.set(groupId, title);
-        await prepareDbGroupTarget({
-          profile,
-          api,
-          groupId,
-          title,
-          rawJson: JSON.stringify(group2),
-          pinnedIds,
-          hiddenIds
-        });
+      params.progress?.(`syncing group directory for ${groupIds.length} group(s)`);
+      for (const groupId of groupIds) {
+        let group2;
+        let title;
+        try {
+          try {
+            group2 = await fetchGroupInfoRecord(api, groupId);
+            title = extractGroupTitle(group2);
+          } catch (error) {
+            const message = toErrorText2(error);
+            params.progress?.(`group ${groupId}: metadata unavailable (${message}), continuing`);
+            summary.syncState.push({
+              kind: "group",
+              groupId,
+              status: "warning",
+              stage: "metadata",
+              error: message
+            });
+          }
+          const { memberSnapshotError } = await prepareDbGroupTarget({
+            profile,
+            api,
+            groupId,
+            group: group2,
+            title,
+            rawJson: group2 ? JSON.stringify(group2) : void 0,
+            pinnedIds,
+            hiddenIds,
+            hydrateMembers: Boolean(group2)
+          });
+          if (memberSnapshotError) {
+            params.progress?.(`group ${groupId}: member snapshot unavailable (${memberSnapshotError}), continuing`);
+            summary.syncState.push({
+              kind: "group",
+              groupId,
+              status: "warning",
+              stage: "members",
+              error: memberSnapshotError
+            });
+          }
+          targetGroupIds.add(groupId);
+          titleById.set(groupId, title);
+        } catch (error) {
+          const message = toErrorText2(error);
+          params.progress?.(`group ${groupId}: skipped (${message})`);
+          await setSyncState({
+            profile,
+            scopeThreadId: groupId,
+            threadType: "group",
+            status: "error",
+            error: message
+          });
+          summary.syncState.push({
+            kind: "group",
+            groupId,
+            status: "error",
+            stage: "prepare",
+            error: message
+          });
+        }
       }
       await syncDbGroupHistoryFull({
         profile,
@@ -4746,18 +5058,29 @@ async function runDbSync(params) {
       if (!params.groupId) {
         throw new Error("Missing group id for db sync group.");
       }
-      const groupInfo = await api.getGroupInfo(params.groupId);
-      const group2 = groupInfo.gridInfoMap[params.groupId];
-      const title = typeof group2?.name === "string" && group2.name.trim() ? group2.name.trim() : void 0;
-      await prepareDbGroupTarget({
+      const group2 = await fetchGroupInfoRecord(api, params.groupId);
+      const title = extractGroupTitle(group2);
+      const { memberSnapshotError } = await prepareDbGroupTarget({
         profile,
         api,
         groupId: params.groupId,
+        group: group2,
         title,
         rawJson: group2 ? JSON.stringify(group2) : void 0,
         pinnedIds,
-        hiddenIds
+        hiddenIds,
+        hydrateMembers: Boolean(group2)
       });
+      if (memberSnapshotError) {
+        params.progress?.(`group ${params.groupId}: member snapshot unavailable (${memberSnapshotError}), continuing`);
+        summary.syncState.push({
+          kind: "group",
+          groupId: params.groupId,
+          status: "warning",
+          stage: "members",
+          error: memberSnapshotError
+        });
+      }
       await syncDbGroupHistoryFull({
         profile,
         api,
@@ -4816,8 +5139,8 @@ async function buildGroupsDetailed(api) {
   const groups = await api.getAllGroups();
   const ids = Object.keys(groups.gridVerMap ?? {});
   if (ids.length === 0) return [];
-  const info = await api.getGroupInfo(ids);
-  return ids.map((id) => info.gridInfoMap?.[id]).filter((item) => Boolean(item));
+  const info = await fetchGroupInfoRecords(api, ids);
+  return ids.map((id) => info.get(id)).filter((item) => Boolean(item));
 }
 function normalizeGroupMemberId(value) {
   if (typeof value === "number" && Number.isFinite(value)) {
@@ -4828,9 +5151,8 @@ function normalizeGroupMemberId(value) {
   if (!trimmed) return "";
   return trimmed.replace(/_\d+$/, "");
 }
-async function listGroupMemberRows(api, groupId) {
-  const info = await api.getGroupInfo(groupId);
-  const groupInfo = info.gridInfoMap[groupId];
+async function listGroupMemberRows(api, groupId, preloadedGroupInfo) {
+  const groupInfo = preloadedGroupInfo ?? await fetchGroupInfoRecord(api, groupId);
   if (!groupInfo) {
     throw new Error(`Group not found: ${groupId}`);
   }
@@ -4854,10 +5176,9 @@ async function listGroupMemberRows(api, groupId) {
       ...Array.from(currentMemberMap.keys())
     ])
   );
-  const profiles = ids.length > 0 ? await api.getGroupMembersInfo(ids) : { profiles: {} };
-  const rawProfileMap = profiles.profiles;
+  const profileLookup = ids.length > 0 ? await fetchGroupMemberProfiles(api, ids) : /* @__PURE__ */ new Map();
   const profileMap = /* @__PURE__ */ new Map();
-  for (const [key, profile] of Object.entries(rawProfileMap)) {
+  for (const [key, profile] of profileLookup.entries()) {
     if (!profile) continue;
     const normalizedKey = normalizeGroupMemberId(key);
     if (normalizedKey && !profileMap.has(normalizedKey)) {
@@ -4912,7 +5233,7 @@ function isListenerAlreadyStarted(error) {
   if (!(error instanceof Error)) return false;
   return /already started/i.test(error.message);
 }
-function toErrorText(error) {
+function toErrorText2(error) {
   return error instanceof Error ? error.message : String(error);
 }
 var SHUTDOWN_CALLBACKS = /* @__PURE__ */ new Set();
@@ -4950,7 +5271,7 @@ async function runShutdownCallbacks(signal) {
         "process.signal.callback_error",
         {
           signal,
-          message: toErrorText(error)
+          message: toErrorText2(error)
         },
         void 0
       );
@@ -5033,7 +5354,7 @@ async function withUploadListener(api, command, task) {
     writeDebugLine(
       "msg.upload.listener.error",
       {
-        message: toErrorText(error)
+        message: toErrorText2(error)
       },
       command
     );
@@ -5075,7 +5396,7 @@ async function withUploadListener(api, command, task) {
         finish();
       };
       const onConnectError = (error) => {
-        finish(new Error(`Upload listener connection error: ${toErrorText(error)}`));
+        finish(new Error(`Upload listener connection error: ${toErrorText2(error)}`));
       };
       const onConnectClosed = (code, reason) => {
         finish(
@@ -5713,7 +6034,7 @@ async function parseCredentialFile(filePath) {
     language: parsed.language
   };
 }
-function sleep(ms) {
+function sleep3(ms) {
   return new Promise((resolve) => {
     setTimeout(resolve, ms);
   });
@@ -5728,7 +6049,7 @@ async function waitForFileContent(filePath, timeoutMs) {
       }
     } catch {
     }
-    await sleep(150);
+    await sleep3(150);
   }
   throw new Error(`Timed out waiting for QR image file: ${filePath}`);
 }
@@ -7081,6 +7402,15 @@ msg.command("send <threadId> <message>").option("-g, --group", "Send to group").
       )
     });
     const payloadChunks = deliveryPlan.chunks;
+    const sendMessage = retrySendMethod(
+      api.sendMessage.bind(api),
+      command,
+      (_payload, targetThreadId, targetThreadType) => ({
+        kind: "msg.send",
+        threadId: targetThreadId,
+        threadType: targetThreadType === ThreadType3.Group ? "group" : "user"
+      })
+    );
     const responses = [];
     const sentPayloads = [];
     for (let index = 0; index < payloadChunks.length; index += 1) {
@@ -7090,7 +7420,7 @@ msg.command("send <threadId> <message>").option("-g, --group", "Send to group").
         quote
       } : chunk;
       sentPayloads.push(chunkPayload);
-      responses.push(await api.sendMessage(chunkPayload, threadId, threadType));
+      responses.push(await sendMessage(chunkPayload, threadId, threadType));
     }
     const response = responses.length === 1 ? responses[0] : {
       chunked: true,
@@ -7155,6 +7485,16 @@ msg.command("image <threadId> [file]").option("-u, --url <url>", "Image URL (rep
   wrapAction(
     async (threadId, file, opts, command) => {
       const { api, profile } = await requireApi(command);
+      const sendMessage = retrySendMethod(
+        api.sendMessage.bind(api),
+        command,
+        (payload, targetThreadId, targetThreadType) => ({
+          kind: "msg.image",
+          threadId: targetThreadId,
+          threadType: targetThreadType === ThreadType3.Group ? "group" : "user",
+          attachmentCount: payload && typeof payload === "object" && Array.isArray(payload.attachments) ? payload.attachments.length : void 0
+        })
+      );
       const normalizedFile = file ? normalizeMediaInput(file) : void 0;
       const files = [normalizedFile, ...normalizeInputList(opts.url)].filter(Boolean);
       const urlInputs = files.filter((entry) => isHttpUrl(entry));
@@ -7176,7 +7516,7 @@ msg.command("image <threadId> [file]").option("-u, --url <url>", "Image URL (rep
           throw new Error("Provide at least one image file or --url.");
         }
         await assertFilesExist(attachments);
-        const response = await api.sendMessage(
+        const response = await sendMessage(
           {
             msg: opts.message ?? "",
             attachments
@@ -7218,6 +7558,16 @@ msg.command("video <threadId> [file]").option("-u, --url <url>", "Video URL (rep
     async (threadId, file, opts, command) => {
       const { api, profile } = await requireApi(command);
       const threadType = asThreadType(opts.group);
+      const sendMessage = retrySendMethod(
+        api.sendMessage.bind(api),
+        command,
+        (payload, targetThreadId, targetThreadType) => ({
+          kind: "msg.video.fallback",
+          threadId: targetThreadId,
+          threadType: targetThreadType === ThreadType3.Group ? "group" : "user",
+          attachmentCount: payload && typeof payload === "object" && Array.isArray(payload.attachments) ? payload.attachments.length : void 0
+        })
+      );
       const normalizedFile = file ? normalizeMediaInput(file) : void 0;
       const files = [normalizedFile, ...normalizeInputList(opts.url)].filter(Boolean);
       const urlInputs = files.filter((entry) => isHttpUrl(entry));
@@ -7339,7 +7689,7 @@ msg.command("video <threadId> [file]").option("-u, --url <url>", "Video URL (rep
         const response = await withUploadListener(
           api,
           command,
-          async () => api.sendMessage(
+          async () => sendMessage(
             {
               msg: opts.message ?? "",
               attachments
@@ -7383,6 +7733,15 @@ msg.command("voice <threadId> [file]").option("-u, --url <url>", "Voice URL (rep
     async (threadId, file, opts, command) => {
       const { api, profile } = await requireApi(command);
       const type = asThreadType(opts.group);
+      const sendVoice = retrySendMethod(
+        api.sendVoice.bind(api),
+        command,
+        (_payload, targetThreadId, targetThreadType) => ({
+          kind: "msg.voice",
+          threadId: targetThreadId,
+          threadType: targetThreadType === ThreadType3.Group ? "group" : "user"
+        })
+      );
       const normalizedFile = file ? normalizeMediaInput(file) : void 0;
       const files = [normalizedFile, ...normalizeInputList(opts.url)].filter(Boolean);
       if (files.length === 0) {
@@ -7408,7 +7767,7 @@ msg.command("voice <threadId> [file]").option("-u, --url <url>", "Voice URL (rep
         const uploaded = await api.uploadAttachment(attachments, threadId, type);
         for (const item of uploaded) {
           if (item.fileType === "others" || item.fileType === "video") {
-            results.push(await api.sendVoice({ voiceUrl: item.fileUrl }, threadId, type));
+            results.push(await sendVoice({ voiceUrl: item.fileUrl }, threadId, type));
           }
         }
         if (results.length === 0) {
@@ -7466,7 +7825,16 @@ msg.command("sticker <threadId> <stickerId>").option("-g, --group", "Send to gro
 msg.command("link <threadId> <url>").option("-g, --group", "Send to group").description("Send link").action(
   wrapAction(async (threadId, url, opts, command) => {
     const { api, profile } = await requireApi(command);
-    const response = await api.sendLink({ link: url }, threadId, asThreadType(opts.group));
+    const sendLink = retrySendMethod(
+      api.sendLink.bind(api),
+      command,
+      (_payload, targetThreadId, targetThreadType) => ({
+        kind: "msg.link",
+        threadId: targetThreadId,
+        threadType: targetThreadType === ThreadType3.Group ? "group" : "user"
+      })
+    );
+    const response = await sendLink({ link: url }, threadId, asThreadType(opts.group));
     output(response, false);
     if (await shouldWriteToDb(profile)) {
       scheduleDbWrite(profile, command, "msg.link.db.persist_error", async () => {
@@ -7578,6 +7946,15 @@ msg.command("edit <msgId> <cliMsgId> <threadId> <message>").option("-g, --group"
     async (msgId, cliMsgId, threadId, message, opts, command) => {
       const { api } = await requireApi(command);
       const type = asThreadType(opts.group);
+      const sendMessage = retrySendMethod(
+        api.sendMessage.bind(api),
+        command,
+        (_payload, targetThreadId, targetThreadType) => ({
+          kind: "msg.edit.resend",
+          threadId: targetThreadId,
+          threadType: targetThreadType === ThreadType3.Group ? "group" : "user"
+        })
+      );
       const undoResponse = await api.undo(
         {
           msgId,
@@ -7586,7 +7963,7 @@ msg.command("edit <msgId> <cliMsgId> <threadId> <message>").option("-g, --group"
         threadId,
         type
       );
-      const sendResponse = await api.sendMessage(message, threadId, type);
+      const sendResponse = await sendMessage(message, threadId, type);
       output(
         {
           mode: "undo+send",
@@ -7603,6 +7980,16 @@ msg.command("upload <arg1> [arg2]").option("-u, --url <url>", "File URL (repeata
   wrapAction(
     async (arg1, arg2, opts, command) => {
       const { api, profile } = await requireApi(command);
+      const sendMessage = retrySendMethod(
+        api.sendMessage.bind(api),
+        command,
+        (payload, targetThreadId, targetThreadType) => ({
+          kind: "msg.upload",
+          threadId: targetThreadId,
+          threadType: targetThreadType === ThreadType3.Group ? "group" : "user",
+          attachmentCount: payload && typeof payload === "object" && Array.isArray(payload.attachments) ? payload.attachments.length : void 0
+        })
+      );
       const inputs = normalizeInputList(opts.url);
       const urlInputs = inputs.filter((entry) => isHttpUrl(entry));
       const localInputs = inputs.filter((entry) => !isHttpUrl(entry));
@@ -7678,7 +8065,7 @@ msg.command("upload <arg1> [arg2]").option("-u, --url <url>", "File URL (repeata
         const response = await withUploadListener(
           api,
           command,
-          async () => api.sendMessage(
+          async () => sendMessage(
             {
               msg: "",
               attachments
@@ -8775,12 +9162,17 @@ ${replyContextText}` : replyContextText;
           }
           await emitWebhook(payload);
           if (opts.echo && rawText.trim().length > 0) {
+            const sendMessage = retrySendMethod(
+              api.sendMessage.bind(api),
+              command,
+              (_sendPayload, targetThreadId, targetThreadType) => ({
+                kind: "listen.echo",
+                threadId: targetThreadId,
+                threadType: targetThreadType === ThreadType3.Group ? "group" : "user"
+              })
+            );
             try {
-              await api.sendMessage(
-                { msg: processedText },
-                message.threadId,
-                message.type
-              );
+              await sendMessage({ msg: processedText }, message.threadId, message.type);
             } catch (error) {
               console.error(
                 `Echo failed: ${error instanceof Error ? error.message : String(error)}`
@@ -8886,7 +9278,7 @@ ${replyContextText}` : replyContextText;
                       code,
                       reason: reason || void 0,
                       delayMs: keepAliveRestartDelayMs,
-                      message: toErrorText(error),
+                      message: toErrorText2(error),
                       sessionId
                     },
                     command

package/package.json

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