openzca 0.1.15 → 0.1.16

package/README.md

@@ -206,7 +206,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`

package/dist/cli.js

@@ -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 = [];
@@ -2791,6 +2883,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 +2914,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 +2942,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.16",
   "description": "Open-source zca-compatible CLI to integrate Zalo with OpenClaw",
   "type": "module",
   "bin": {