openzca 0.1.25 → 0.1.27

package/README.md

@@ -76,7 +76,7 @@ You can also open the saved file manually (for example: `open qr.png` on macOS).
 | `openzca msg delete <msgId> <cliMsgId> <uidFrom> <threadId>` | Delete a message |
 | `openzca msg undo <msgId> <cliMsgId> <threadId>` | Recall a sent message |
 | `openzca msg upload <arg1> [arg2]` | Upload and send file(s) |
-| `openzca msg recent <threadId>` | List recent messages (`-n`, `--json`); group mode uses direct group-history API |
+| `openzca msg recent <threadId>` | List recent messages (`-n`, `--json`, newest-first); group mode uses direct group-history API |
 
 Media commands accept local files, `file://` paths, and repeatable `--url` options. Add `--group` for group threads.
 Local paths using `~` are expanded automatically (for positional file args, `--url`, and `OPENZCA_LISTEN_MEDIA_DIR`).
@@ -272,6 +272,9 @@ Listener resilience override:
 - `OPENZCA_LISTEN_DOWNLOAD_QUOTE_MEDIA`: download quoted attachment URLs (if present) into inbound media cache.
   - Default: enabled.
   - Set to `0` to keep only quote metadata/URLs without downloading.
+- `OPENZCA_RECENT_USER_MAX_PAGES`: max websocket history pages to scan for `msg recent` in user/DM mode.
+  - Default: `20`.
+  - Increase if a DM thread is old and not found in the first page.
 - `OPENZCA_LISTEN_ENFORCE_SINGLE_OWNER`: enforce one `listen` owner process per profile.
   - Default: enabled.
   - Set to `0` to allow multiple listeners on the same profile (not recommended).

package/dist/cli.js

@@ -1555,6 +1555,39 @@ async function withUploadListener(api, command, task) {
     api.listener.off("closed", sinkClosed);
   }
 }
+function parseRecentMessageTs(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return Math.trunc(value);
+  }
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (!trimmed) return 0;
+    const parsed = Number(trimmed);
+    if (Number.isFinite(parsed)) {
+      return Math.trunc(parsed);
+    }
+  }
+  return 0;
+}
+function sortRecentMessagesNewestFirst(messages) {
+  return [...messages].sort((left, right) => {
+    const rightTs = parseRecentMessageTs(right.data?.ts);
+    const leftTs = parseRecentMessageTs(left.data?.ts);
+    if (rightTs !== leftTs) return rightTs - leftTs;
+    const rightMsgId = String(right.data?.msgId ?? "");
+    const leftMsgId = String(left.data?.msgId ?? "");
+    if (rightMsgId !== leftMsgId) return rightMsgId.localeCompare(leftMsgId);
+    const rightCliMsgId = String(right.data?.cliMsgId ?? "");
+    const leftCliMsgId = String(left.data?.cliMsgId ?? "");
+    return rightCliMsgId.localeCompare(leftCliMsgId);
+  });
+}
+function getRecentMessageCursor(message) {
+  if (!message) return "";
+  const actionId = String(message.data?.actionId ?? "").trim();
+  if (actionId) return actionId;
+  return String(message.data?.msgId ?? "").trim();
+}
 async function fetchRecentGroupMessagesViaApi(api, threadId, count) {
   const historyApi = api.getGroupChatHistory;
   if (typeof historyApi !== "function") {
@@ -1564,12 +1597,31 @@ async function fetchRecentGroupMessagesViaApi(api, threadId, count) {
   }
   const response = await historyApi(threadId, count);
   const messages = Array.isArray(response?.groupMsgs) ? response.groupMsgs : [];
-  return messages.slice(0, count);
+  return sortRecentMessagesNewestFirst(messages).slice(0, count);
 }
 async function fetchRecentUserMessagesViaListener(api, threadId, count) {
   return new Promise((resolve, reject) => {
     let settled = false;
     const collected = [];
+    const seenMessageKeys = /* @__PURE__ */ new Set();
+    const requestedCursors = /* @__PURE__ */ new Set();
+    const maxPages = parsePositiveIntFromEnv("OPENZCA_RECENT_USER_MAX_PAGES", 20);
+    let pagesRequested = 0;
+    const toKey = (message) => {
+      const msgId = String(message.data?.msgId ?? "");
+      const cliMsgId = String(message.data?.cliMsgId ?? "");
+      return `${msgId}:${cliMsgId}`;
+    };
+    const requestPage = (lastId) => {
+      const cursor = String(lastId ?? "").trim();
+      if (cursor) {
+        if (requestedCursors.has(cursor)) return false;
+        requestedCursors.add(cursor);
+      }
+      pagesRequested += 1;
+      api.listener.requestOldMessages(ThreadType.User, cursor || null);
+      return true;
+    };
     const cleanup = () => {
       clearTimeout(timeoutId);
       api.listener.off("connected", onConnected);
@@ -1589,11 +1641,11 @@ async function fetchRecentUserMessagesViaListener(api, threadId, count) {
         reject(error);
         return;
       }
-      resolve(collected.slice(0, count));
+      resolve(sortRecentMessagesNewestFirst(collected).slice(0, count));
     };
     const onConnected = () => {
       try {
-        api.listener.requestOldMessages(ThreadType.User, null);
+        requestPage(null);
       } catch (error) {
         finish(error);
       }
@@ -1603,10 +1655,47 @@ async function fetchRecentUserMessagesViaListener(api, threadId, count) {
       const typedMessages = messages;
       for (const message of typedMessages) {
         if (message.threadId === threadId) {
+          const key = toKey(message);
+          if (seenMessageKeys.has(key)) continue;
+          seenMessageKeys.add(key);
           collected.push(message);
         }
       }
-      finish();
+      if (collected.length >= count) {
+        finish();
+        return;
+      }
+      if (typedMessages.length === 0) {
+        finish();
+        return;
+      }
+      if (pagesRequested >= maxPages) {
+        finish();
+        return;
+      }
+      let oldest = null;
+      for (const message of typedMessages) {
+        if (!oldest) {
+          oldest = message;
+          continue;
+        }
+        if (parseRecentMessageTs(message.data?.ts) < parseRecentMessageTs(oldest.data?.ts)) {
+          oldest = message;
+        }
+      }
+      const nextCursor = getRecentMessageCursor(oldest);
+      if (!nextCursor) {
+        finish();
+        return;
+      }
+      try {
+        const requested = requestPage(nextCursor);
+        if (!requested) {
+          finish();
+        }
+      } catch (error) {
+        finish(error);
+      }
     };
     const onError = (error) => {
       finish(error);

package/package.json

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