openzca 0.1.51 → 0.1.52

package/README.md

@@ -48,6 +48,9 @@ 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":"..."}'
 
+# Inspect how a formatted message expands before sending/chunking
+openzca msg analyze-text GROUP_ID "- item one\n- item two" --group --json
+
 # Listen for incoming messages
 openzca listen
 
@@ -100,6 +103,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.), group @mention resolution (`--raw` to skip formatting), and quote replies via `--reply-id` or `--reply-message` |
+| `openzca msg analyze-text <threadId> <message>` | Build and inspect the exact text payload `msg send` would hand to `zca-js`, including rendered text length, style count, mention count, `textProperties` size, and request size estimate |
 | `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`) |
@@ -123,6 +127,7 @@ 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.
+Use `openzca msg analyze-text ... --json` when you need to predict whether a formatted reply will expand into a large `textProperties` payload before attempting delivery.
 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.

package/dist/cli.js

@@ -1979,9 +1979,6 @@ function parseTimeBoundaryInput(value, _nowMs = Date.now()) {
   return void 0;
 }
 
-// src/lib/text-send.ts
-import { ThreadType } from "zca-js";
-
 // src/lib/group-mentions.ts
 var ALLOWED_START_BOUNDARY_CHARS = /* @__PURE__ */ new Set(["(", "[", "{", "<", '"', ",", ";", ":"]);
 var ALLOWED_END_BOUNDARY_CHARS = /* @__PURE__ */ new Set([",", ";", ":", "!", "?", ")", "]", "}", ">", '"']);
@@ -2086,6 +2083,9 @@ function isMentionStartBoundary(text, atIndex) {
   return /\s/u.test(previous) || ALLOWED_START_BOUNDARY_CHARS.has(previous);
 }
 
+// src/lib/text-send.ts
+import { ThreadType } from "zca-js";
+
 // src/lib/text-styles.ts
 import { TextStyle } from "zca-js";
 var TAG_STYLE_MAP = {
@@ -2346,6 +2346,39 @@ async function buildTextSendPayload(params) {
     mentions
   };
 }
+async function analyzeTextSendPayload(params) {
+  const payload = await buildTextSendPayload(params);
+  const payloadObject = normalizeTextSendPayload(payload);
+  const textProperties = buildTextProperties(payloadObject.styles);
+  const mentionInfo = buildMentionInfo(
+    params.threadType,
+    payloadObject.msg,
+    payloadObject.mentions
+  );
+  const requestParams = omitUndefined({
+    message: payloadObject.msg,
+    clientId: 17e11,
+    mentionInfo,
+    imei: params.threadType === ThreadType.Group ? void 0 : "000000000000000",
+    ttl: 0,
+    visibility: params.threadType === ThreadType.Group ? 0 : void 0,
+    toid: params.threadType === ThreadType.Group ? void 0 : params.threadId,
+    grid: params.threadType === ThreadType.Group ? params.threadId : void 0,
+    textProperties
+  });
+  return {
+    payload,
+    payloadObject,
+    rawInputLength: params.message.length,
+    renderedTextLength: payloadObject.msg.length,
+    styleCount: payloadObject.styles?.length ?? 0,
+    mentionCount: payloadObject.mentions?.length ?? 0,
+    textPropertiesLength: textProperties?.length ?? 0,
+    mentionInfoLength: mentionInfo?.length ?? 0,
+    requestParamsLengthEstimate: JSON.stringify(requestParams).length,
+    sendPath: params.threadType === ThreadType.Group ? mentionInfo ? "mention" : "sendmsg" : "sms"
+  };
+}
 async function resolveGroupMentionsIfNeeded(params, text) {
   if (params.threadType !== ThreadType.Group) {
     return void 0;
@@ -2360,6 +2393,61 @@ async function resolveGroupMentionsIfNeeded(params, text) {
   const mentions = resolveOutboundGroupMentions(text, members);
   return mentions.length > 0 ? mentions : void 0;
 }
+function normalizeTextSendPayload(payload) {
+  if (typeof payload === "string") {
+    return { msg: payload };
+  }
+  return payload;
+}
+function buildTextProperties(styles) {
+  if (!styles || styles.length === 0) {
+    return void 0;
+  }
+  return JSON.stringify({
+    styles: styles.map((style) => {
+      if (style.st === "ind_$") {
+        return omitUndefined({
+          start: style.start,
+          len: style.len,
+          st: `ind_${style.indentSize ?? 1}0`
+        });
+      }
+      return {
+        start: style.start,
+        len: style.len,
+        st: style.st
+      };
+    }),
+    ver: 0
+  });
+}
+function buildMentionInfo(threadType, msg2, mentions) {
+  if (threadType !== ThreadType.Group || !mentions || mentions.length === 0) {
+    return void 0;
+  }
+  let totalMentionLen = 0;
+  const mentionsFinal = mentions.filter((mention) => mention.pos >= 0 && Boolean(mention.uid) && mention.len > 0).map((mention) => {
+    totalMentionLen += mention.len;
+    return {
+      pos: mention.pos,
+      uid: mention.uid,
+      len: mention.len,
+      type: mention.uid === "-1" ? 1 : 0
+    };
+  });
+  if (totalMentionLen > msg2.length) {
+    throw new Error("Invalid mentions: total mention characters exceed message length");
+  }
+  if (mentionsFinal.length === 0) {
+    return void 0;
+  }
+  return JSON.stringify(mentionsFinal);
+}
+function omitUndefined(value) {
+  return Object.fromEntries(
+    Object.entries(value).filter(([, entry]) => entry !== void 0)
+  );
+}
 
 // src/lib/video-send.ts
 import { execFile } from "child_process";
@@ -6453,6 +6541,25 @@ msg.command("send <threadId> <message>").option("-g, --group", "Send to group").
     }
   })
 );
+msg.command("analyze-text <threadId> <message>").option("-g, --group", "Analyze as group text").option("--raw", "Analyze raw text without parsing formatting markers").option("-j, --json", "JSON output").description("Build and analyze the exact text payload that msg send would hand to zca-js. Useful for pre-send chunking/debugging.").action(
+  wrapAction(async (threadId, message, opts, command) => {
+    const threadType = asThreadType(opts.group);
+    const mentionProbeText = opts.raw ? message : parseTextStyles(message).text;
+    let listGroupMembers;
+    if (threadType === ThreadType3.Group && hasPotentialOutboundGroupMention(mentionProbeText)) {
+      const { api } = await requireApi(command);
+      listGroupMembers = (groupId) => listGroupMentionMembers(api, groupId);
+    }
+    const analysis = await analyzeTextSendPayload({
+      message,
+      raw: opts.raw,
+      threadType,
+      threadId,
+      listGroupMembers
+    });
+    output(analysis, shouldOutputJson(opts));
+  })
+);
 msg.command("image <threadId> [file]").option("-u, --url <url>", "Image URL (repeatable)", collectValues, []).option("-m, --message <message>", "Caption").option("-g, --group", "Send to group").description("Send image(s) from file or URL").action(
   wrapAction(
     async (threadId, file, opts, command) => {

package/package.json

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