openzca 0.1.15 → 0.1.17

package/README.md

@@ -1,13 +1,8 @@
 # openzca
 
-Free and open-source CLI for Zalo, built on [zca-js](https://github.com/nicenathapong/zca-js). Command structure compatible with [zca-cli.dev/docs](https://zca-cli.dev/docs).
+Free and open-source CLI for Zalo, built on [zca-js](https://github.com/RFS-ADRENO/zca-js). Command structure compatible with [zca-cli.dev/docs](https://zca-cli.dev/docs).
 
-## Integrate with OpenClaw ZaloUser plugin
-
-Prompt:
-```
-help me to enable zalouser openclaw plugin. However, don't install zca cli follow their instruction, please use: npm install -g openzca@latest
-```
+## Integrate with OpenClaw OpenZalo plugin (including legacy `zalouser`)
 
 
 ## Install
@@ -206,7 +201,10 @@ It also includes stable routing fields for downstream tools:
 
 - `threadId`, `targetId`, `conversationId`
 - `senderId`, `toId`, `chatType`, `msgType`, `timestamp`
+- `mentions` (normalized mention entities: `uid`, `pos`, `len`, `type`, optional `text`)
+- `mentionIds` (flattened mention user IDs)
 - `metadata.threadId`, `metadata.targetId`, `metadata.senderId`, `metadata.toId`
+- `metadata.mentions`, `metadata.mentionIds`, `metadata.mentionCount`
 - `quote` and `metadata.quote` when the inbound message is a reply to a previous message
   - Includes parsed `quote.attach` and extracted `quote.mediaUrls` when attachment URLs are present.
 - `quoteMediaPath`, `quoteMediaPaths`, `quoteMediaUrl`, `quoteMediaUrls`, `quoteMediaType`, `quoteMediaTypes`
@@ -293,7 +291,7 @@ Supervised mode notes:
 
 ## Multi-account profiles
 
-Use `--profile <name>` or set `ZCA_PROFILE=<name>` to switch between accounts. Manage profiles with the `account` commands.
+Use `--profile <name>` or set `OPENZCA_PROFILE=<name>` (or legacy `ZCA_PROFILE=<name>`) to switch between accounts. Manage profiles with the `account` commands.
 
 Profile data is stored in `~/.openzca/` (override with `OPENZCA_HOME`):
 

package/dist/cli.js

@@ -164,7 +164,7 @@ async function removeProfile(name) {
 }
 async function resolveProfileName(flagProfile) {
   const db = await ensureProfilesDb();
-  const picked = flagProfile && flagProfile.trim() || process.env.ZCA_PROFILE && process.env.ZCA_PROFILE.trim() || db.defaultProfile || DEFAULT_PROFILE;
+  const picked = flagProfile && flagProfile.trim() || (process.env.OPENZCA_PROFILE?.trim() || process.env.ZCA_PROFILE?.trim()) || db.defaultProfile || DEFAULT_PROFILE;
   if (!db.profiles[picked]) {
     if (picked === DEFAULT_PROFILE) {
       await ensureProfile(DEFAULT_PROFILE);
@@ -765,7 +765,7 @@ async function currentProfile(_command) {
 async function profileForLogin() {
   const opts = program.opts();
   const explicit = opts.profile?.trim();
-  const fromEnv = process.env.ZCA_PROFILE?.trim();
+  const fromEnv = process.env.OPENZCA_PROFILE?.trim() || process.env.ZCA_PROFILE?.trim();
   if (explicit) {
     await ensureProfile(explicit);
     return explicit;
@@ -1459,6 +1459,98 @@ function buildReplyMediaAttachedText(params) {
   }
   return lines.join("\n");
 }
+function parseOptionalInt(value) {
+  const numeric = typeof value === "number" ? value : typeof value === "string" ? Number(value) : Number.NaN;
+  if (!Number.isFinite(numeric)) return void 0;
+  return Math.trunc(numeric);
+}
+function buildInboundMention(record, rawText) {
+  const uid = getStringCandidate(record, ["uid", "userId", "user_id", "id"]);
+  if (!uid) return null;
+  const pos = parseOptionalInt(record.pos ?? record.offset ?? record.start ?? record.index);
+  const len = parseOptionalInt(record.len ?? record.length);
+  const type = parseOptionalInt(record.type ?? record.kind);
+  let text = getStringCandidate(record, ["text", "label", "name"]) || (typeof pos === "number" && typeof len === "number" && len > 0 && pos >= 0 && pos < rawText.length ? rawText.slice(pos, Math.min(rawText.length, pos + len)) : "");
+  if (!text.trim()) {
+    text = "";
+  }
+  return {
+    uid,
+    ...typeof pos === "number" ? { pos } : {},
+    ...typeof len === "number" ? { len } : {},
+    ...typeof type === "number" ? { type } : {},
+    ...text ? { text } : {}
+  };
+}
+function collectInboundMentions(value, sink, rawText, depth = 0) {
+  if (depth > 6 || sink.size >= 64 || value === null || value === void 0) {
+    return;
+  }
+  if (typeof value === "string") {
+    if (!looksLikeStructuredJsonString(value)) return;
+    try {
+      const parsed = JSON.parse(value);
+      collectInboundMentions(parsed, sink, rawText, depth + 1);
+    } catch {
+    }
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      const mention = asObject(item) ? buildInboundMention(item, rawText) : null;
+      if (mention) {
+        const key = `${mention.uid}|${mention.pos ?? ""}|${mention.len ?? ""}|${mention.type ?? ""}`;
+        sink.set(key, mention);
+        continue;
+      }
+      collectInboundMentions(item, sink, rawText, depth + 1);
+      if (sink.size >= 64) return;
+    }
+    return;
+  }
+  const record = asObject(value);
+  if (!record) return;
+  const direct = buildInboundMention(record, rawText);
+  if (direct) {
+    const key = `${direct.uid}|${direct.pos ?? ""}|${direct.len ?? ""}|${direct.type ?? ""}`;
+    sink.set(key, direct);
+  }
+  const mentionKeys = [
+    "mentions",
+    "mentionInfo",
+    "mention_info",
+    "mentionList",
+    "mention_list",
+    "mention"
+  ];
+  for (const key of mentionKeys) {
+    if (!(key in record)) continue;
+    collectInboundMentions(record[key], sink, rawText, depth + 1);
+    if (sink.size >= 64) return;
+  }
+  for (const nested of Object.values(record)) {
+    collectInboundMentions(nested, sink, rawText, depth + 1);
+    if (sink.size >= 64) return;
+  }
+}
+function extractInboundMentions(params) {
+  const sink = /* @__PURE__ */ new Map();
+  const candidates = [
+    params.messageData.mentions,
+    params.messageData.mentionInfo,
+    params.messageData.mention_info,
+    params.messageData.mentionList,
+    params.messageData.mention_list,
+    params.messageData.mention,
+    params.messageData.content,
+    params.parsedContent
+  ];
+  for (const candidate of candidates) {
+    collectInboundMentions(candidate, sink, params.rawText);
+    if (sink.size >= 64) break;
+  }
+  return [...sink.values()];
+}
 function normalizeFriendLookupRows(value) {
   const queue = [value];
   const rows = [];
@@ -1561,7 +1653,7 @@ program.hook("preAction", (_parent, actionCommand) => {
       argv: process.argv.slice(2),
       cwd: process.cwd(),
       profileFlag: getDebugOptions(actionCommand).profile ?? null,
-      envProfile: process.env.ZCA_PROFILE ?? null
+      envProfile: process.env.OPENZCA_PROFILE ?? process.env.ZCA_PROFILE ?? null
     },
     actionCommand
   );
@@ -1990,6 +2082,32 @@ msg.command("undo <msgId> <cliMsgId> <threadId>").option("-g, --group", "Undo in
     }
   )
 );
+msg.command("edit <msgId> <cliMsgId> <threadId> <message>").option("-g, --group", "Edit in group").description("Edit message (compatibility shim: recall old message then resend new text)").action(
+  wrapAction(
+    async (msgId, cliMsgId, threadId, message, opts, command) => {
+      const { api } = await requireApi(command);
+      const type = asThreadType(opts.group);
+      const undoResponse = await api.undo(
+        {
+          msgId,
+          cliMsgId
+        },
+        threadId,
+        type
+      );
+      const sendResponse = await api.sendMessage(message, threadId, type);
+      output(
+        {
+          mode: "undo+send",
+          nativeEditSupported: false,
+          undo: undoResponse,
+          send: sendResponse
+        },
+        false
+      );
+    }
+  )
+);
 msg.command("upload <arg1> [arg2]").option("-u, --url <url>", "File URL (repeatable)", collectValues, []).option("-g, --group", "Upload in group").description("Upload and send file(s)").action(
   wrapAction(
     async (arg1, arg2, opts, command) => {
@@ -2072,6 +2190,75 @@ msg.command("recent <threadId>").option("-g, --group", "List recent messages for
     }
   )
 );
+msg.command("pin <threadId>").option("-g, --group", "Pin group conversation").description("Pin conversation").action(
+  wrapAction(async (threadId, opts, command) => {
+    const { api } = await requireApi(command);
+    const type = asThreadType(opts.group);
+    const response = await api.setPinnedConversations(true, threadId, type);
+    output(
+      {
+        threadId,
+        threadType: type === ThreadType.Group ? "group" : "user",
+        pinned: true,
+        response
+      },
+      false
+    );
+  })
+);
+msg.command("unpin <threadId>").option("-g, --group", "Unpin group conversation").description("Unpin conversation").action(
+  wrapAction(async (threadId, opts, command) => {
+    const { api } = await requireApi(command);
+    const type = asThreadType(opts.group);
+    const response = await api.setPinnedConversations(false, threadId, type);
+    output(
+      {
+        threadId,
+        threadType: type === ThreadType.Group ? "group" : "user",
+        pinned: false,
+        response
+      },
+      false
+    );
+  })
+);
+msg.command("list-pins").option("-j, --json", "JSON output").description("List pinned conversations").action(
+  wrapAction(async (opts, command) => {
+    const { api } = await requireApi(command);
+    const response = await api.getPinConversations();
+    if (opts.json) {
+      output(response, true);
+      return;
+    }
+    output(
+      response.conversations.map((threadId) => ({
+        threadId,
+        pinned: true
+      })),
+      false
+    );
+  })
+);
+msg.command("member-info <userId>").option("-j, --json", "JSON output").description("Get member/user profile info").action(
+  wrapAction(async (userId, opts, command) => {
+    const { api } = await requireApi(command);
+    const response = await api.getUserInfo(userId);
+    if (opts.json) {
+      output(response, true);
+      return;
+    }
+    const profiles = response.changed_profiles ?? {};
+    const matchedProfile = profiles[userId] ?? profiles[`${userId}_0`] ?? Object.values(profiles)[0] ?? null;
+    output(
+      {
+        userId,
+        found: Boolean(matchedProfile),
+        profile: matchedProfile
+      },
+      false
+    );
+  })
+);
 var group = program.command("group").description("Group management");
 group.command("list").option("-j, --json", "JSON output").description("List groups").action(
   wrapAction(async (opts, command) => {
@@ -2791,6 +2978,12 @@ ${replyContextText}` : replyContextText;
         const senderNameForMetadata = message.type === ThreadType.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({
+          messageData,
+          parsedContent,
+          rawText
+        });
+        const mentionIds = mentions.map((item) => item.uid);
         const timestamp = toEpochSeconds(message.data.ts);
         const payload = {
           threadId: message.threadId,
@@ -2816,6 +3009,8 @@ ${replyContextText}` : replyContextText;
           mediaType,
           mediaTypes: mediaTypes.length > 0 ? mediaTypes : void 0,
           mediaKind: mediaKind ?? void 0,
+          mentions: mentions.length > 0 ? mentions : void 0,
+          mentionIds: mentionIds.length > 0 ? mentionIds : void 0,
           metadata: {
             isGroup: message.type === ThreadType.Group,
             chatType,
@@ -2842,7 +3037,10 @@ ${replyContextText}` : replyContextText;
             mediaUrls: mediaUrls.length > 0 ? mediaUrls : void 0,
             mediaType,
             mediaTypes: mediaTypes.length > 0 ? mediaTypes : void 0,
-            mediaKind: mediaKind ?? void 0
+            mediaKind: mediaKind ?? void 0,
+            mentions: mentions.length > 0 ? mentions : void 0,
+            mentionIds: mentionIds.length > 0 ? mentionIds : void 0,
+            mentionCount: mentions.length > 0 ? mentions.length : void 0
           },
           // Backward-compatible convenience fields.
           chatType,

package/package.json

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