openzca 0.1.57 → 0.1.59

package/README.md

@@ -125,6 +125,7 @@ You can also open the saved file manually (for example: `open qr.png` on macOS).
 
 Media commands accept local files, `file://` paths, and repeatable `--url` options. Add `--group` for group threads.
 `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.
+`openzca msg voice` sends `--url` inputs directly. For local voice files, if both `ffmpeg` and `OPENZCA_VOICE_PUBLISH_CMD` are available, `openzca` normalizes the file to `.m4a`, runs the publish command with the normalized temp file path, expects one public `http(s)` URL on stdout, and sends that URL. Otherwise it falls back to the legacy Zalo upload flow.
 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.
 When formatted text would produce an oversized outbound payload, `openzca msg send` automatically splits it into multiple sequential text messages using the final outbound text and rebased style/mention offsets. The split happens after formatting is parsed, using both rendered text length and estimated request payload size rather than the raw input string.
@@ -176,11 +177,11 @@ For media debugging, grep these events in the debug log:
 | `openzca group info <groupId>` | Get group details |
 | `openzca group members <groupId>` | List members |
 | `openzca group create <name> <members...>` | Create a group |
-| `openzca group poll create <groupId>` | Create a poll (`--question`, repeatable `--option`, optional poll flags) |
-| `openzca group poll detail <pollId>` | Get poll details |
-| `openzca group poll vote <pollId>` | Vote on a poll with repeatable `--option <id>` |
-| `openzca group poll lock <pollId>` | Close a poll |
-| `openzca group poll share <pollId>` | Share a poll |
+| `openzca group poll create <groupId>` | Create a poll (`--question`, repeatable `--option`, optional poll flags, `--json`) |
+| `openzca group poll detail <pollId>` | Get poll details (`--json`) |
+| `openzca group poll vote <pollId>` | Vote on a poll with repeatable `--option <id>` (`--json`) |
+| `openzca group poll lock <pollId>` | Close a poll (`--json`) |
+| `openzca group poll share <pollId>` | Share a poll (`--json`) |
 | `openzca group rename <groupId> <name>` | Rename group |
 | `openzca group avatar <groupId> <file>` | Change group avatar |
 | `openzca group settings <groupId>` | Update settings (`--lock-name`, `--sign-admin`, etc.) |
@@ -201,7 +202,7 @@ For media debugging, grep these events in the debug log:
 | `openzca group leave <groupId>` | Leave group |
 | `openzca group disperse <groupId>` | Disperse group |
 
-Poll creation currently targets group threads only and maps to the existing `zca-js` group poll APIs. `group poll create` requires `--question` plus at least two `--option` values, and also supports `--multi`, `--allow-add-option`, `--hide-vote-preview`, `--anonymous`, and `--expire-ms`.
+Poll creation currently targets group threads only and maps to the existing `zca-js` group poll APIs. `group poll create` requires `--question` plus at least two `--option` values, and also supports `--multi`, `--allow-add-option`, `--hide-vote-preview`, `--anonymous`, `--expire-ms`, and `--json`. Use `--json` to reliably read the returned `poll_id` and option `option_id` values for follow-up detail or vote commands.
 
 ### friend — Friend management
 
@@ -301,6 +302,7 @@ Notes:
 | `openzca listen --db` | Force DB writes for this listener session |
 | `openzca listen --no-db` | Disable DB writes for this listener session |
 | `openzca listen --keep-alive` | Auto-reconnect on disconnect |
+| `openzca listen --self` | Include events produced by the logged-in account |
 | `openzca listen --supervised --raw` | Supervisor mode with lifecycle JSON events (`session_id`, `connected`, `heartbeat`, `error`, `closed`) |
 | `openzca listen --keep-alive --recycle-ms <ms>` | Periodically recycle listener process to avoid stale sessions |
 
@@ -317,8 +319,12 @@ It also includes stable routing fields for downstream tools:
 - `senderId`, `toId`, `chatType`, `msgType`, `timestamp`
 - `mentions` (normalized mention entities: `uid`, `pos`, `len`, `type`, optional `text`)
 - `mentionIds` (flattened mention user IDs)
+- `pollId`, `pollTitle`, `pollOptionIds`, and `poll` when a message or group event carries poll metadata
+- `rawMessage` for poll message payloads, and `rawGroupEvent` for poll group-event payloads
 - `metadata.threadId`, `metadata.targetId`, `metadata.senderId`, `metadata.toId`
 - `metadata.mentions`, `metadata.mentionIds`, `metadata.mentionCount`
+- `metadata.pollId`, `metadata.pollTitle`, `metadata.pollOptionIds`, and `metadata.poll`
+- `metadata.rawMessage` / `metadata.rawGroupEvent` for poll payload schema debugging
 - `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`
@@ -326,6 +332,8 @@ It also includes stable routing fields for downstream tools:
 
 For direct messages, `metadata.senderName` is intentionally omitted so consumers can prefer numeric IDs for routing instead of display-name targets.
 
+By default, zca-js suppresses events produced by the logged-in account. Use `listen --self --raw` when a caller needs to observe its own actions, such as a poll it just created.
+
 When a reply/quoted message is detected, `content` also appends a compact line:
 
 ```text
@@ -433,6 +441,10 @@ Upload/listener coordination overrides:
 - `OPENZCA_UPLOAD_GROUP_PROBE`: allow `msg upload` to probe `getGroupInfo` when auto thread-type detection is enabled.
   - Default: enabled.
   - Set to `0` to skip probe and rely only on cache matches.
+- `OPENZCA_VOICE_PUBLISH_CMD`: optional command used by `msg voice` for local files.
+  - `openzca` passes one normalized `.m4a` temp file path as the first argument.
+  - The command must print exactly one public `http(s)` URL to stdout.
+  - Requires `ffmpeg`; if unset or `ffmpeg` is unavailable, local voice files keep using the legacy Zalo upload flow.
 
 ### account — Multi-account profiles
 

package/dist/cli.js

@@ -4,10 +4,10 @@
 import { createRequire as createRequire2 } from "module";
 import { spawn as spawn2 } from "child_process";
 import fsSync from "fs";
-import fs6 from "fs/promises";
+import fs7 from "fs/promises";
 import net from "net";
-import os4 from "os";
-import path6 from "path";
+import os5 from "os";
+import path7 from "path";
 import readline from "readline/promises";
 import util from "util";
 import { Command } from "commander";
@@ -1735,10 +1735,11 @@ async function imageMetadataGetter(filePath) {
     size: data.length
   };
 }
-function createZaloClient() {
+function createZaloClient(options) {
   return new Zalo({
     imageMetadataGetter,
-    logging: false
+    logging: false,
+    ...options
   });
 }
 function toCredentials(value) {
@@ -1749,14 +1750,14 @@ function toCredentials(value) {
     language: value.language
   };
 }
-async function loginWithStoredCredentials(profileName) {
+async function loginWithStoredCredentials(profileName, options) {
   const stored = await loadCredentials(profileName);
   if (!stored) {
     throw new Error(
       `Profile "${profileName}" has no credentials. Run: auth login`
     );
   }
-  const zalo = createZaloClient();
+  const zalo = createZaloClient(options);
   return zalo.login(toCredentials(stored));
 }
 async function loginWithCredentialPayload(profileName, credentials) {
@@ -2035,6 +2036,96 @@ function buildCreatePollOptions(options) {
   };
 }
 
+// src/lib/listen-poll.ts
+var POLL_ID_KEYS = /* @__PURE__ */ new Set(["pollId", "poll_id", "pollID", "pollid"]);
+var OPTION_ID_KEYS = /* @__PURE__ */ new Set(["optionId", "option_id", "optionID", "optionid"]);
+var TITLE_KEYS = ["question", "title"];
+function looksLikeStructuredJsonString(value) {
+  const trimmed = value.trim();
+  if (trimmed.length < 2) return false;
+  const first = trimmed[0];
+  const last = trimmed[trimmed.length - 1];
+  return first === "{" && last === "}" || first === "[" && last === "]";
+}
+function parseStructuredJsonString(value) {
+  if (!looksLikeStructuredJsonString(value)) return void 0;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return void 0;
+  }
+}
+function normalizeIdentifier(value) {
+  if (typeof value === "number" && Number.isInteger(value) && value > 0) {
+    return Number.isSafeInteger(value) ? value : String(value);
+  }
+  if (typeof value !== "string") return void 0;
+  const normalized = value.trim();
+  if (!/^[1-9]\d*$/.test(normalized)) return void 0;
+  const numeric = Number(normalized);
+  return Number.isSafeInteger(numeric) ? numeric : normalized;
+}
+function firstString(record, keys) {
+  for (const key of keys) {
+    const value = record[key];
+    if (typeof value === "string" && value.trim()) {
+      return value.trim();
+    }
+  }
+  return void 0;
+}
+function asRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  return value;
+}
+function extractInboundPollInfo(...values) {
+  const optionIds = [];
+  const seenOptionIds = /* @__PURE__ */ new Set();
+  let pollId;
+  let title;
+  const pushOptionId = (value) => {
+    const optionId = normalizeIdentifier(value);
+    if (!optionId) return;
+    const key = String(optionId);
+    if (seenOptionIds.has(key)) return;
+    seenOptionIds.add(key);
+    optionIds.push(optionId);
+  };
+  const visit = (value, depth = 0) => {
+    if (depth > 8 || value === null || value === void 0) return;
+    if (typeof value === "string") {
+      const parsed = parseStructuredJsonString(value);
+      if (parsed !== void 0) visit(parsed, depth + 1);
+      return;
+    }
+    if (Array.isArray(value)) {
+      for (const entry of value) visit(entry, depth + 1);
+      return;
+    }
+    const record = asRecord(value);
+    if (!record) return;
+    for (const [key, nested] of Object.entries(record)) {
+      if (!pollId && POLL_ID_KEYS.has(key)) {
+        pollId = normalizeIdentifier(nested);
+      }
+      if (OPTION_ID_KEYS.has(key)) {
+        pushOptionId(nested);
+      }
+    }
+    title ??= firstString(record, TITLE_KEYS);
+    for (const nested of Object.values(record)) {
+      visit(nested, depth + 1);
+    }
+  };
+  for (const value of values) visit(value);
+  if (!pollId) return null;
+  return {
+    pollId,
+    ...title ? { title } : {},
+    ...optionIds.length > 0 ? { optionIds } : {}
+  };
+}
+
 // src/lib/time-range.ts
 var DURATION_PART_RE = /(\d+)\s*(ms|s|m|h|d|w)/gi;
 function durationToMs(input) {
@@ -3066,6 +3157,110 @@ async function sendNativeVideo(params) {
   }
 }
 
+// src/lib/voice-send.ts
+import { execFile as execFile2 } from "child_process";
+import fs6 from "fs/promises";
+import os4 from "os";
+import path6 from "path";
+import { promisify as promisify2 } from "util";
+var execFileAsync2 = promisify2(execFile2);
+function sanitizeOutputBasename(filePath) {
+  const parsed = path6.parse(filePath);
+  const base = parsed.name.trim() || "voice";
+  const sanitized = base.replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+  return sanitized || "voice";
+}
+async function runBinary2(command, args) {
+  try {
+    await execFileAsync2(command, args, {
+      encoding: "utf8",
+      maxBuffer: 10 * 1024 * 1024
+    });
+  } catch (error) {
+    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+      throw new Error(`${command} is required for voice publish mode`);
+    }
+    if (error instanceof Error && "stderr" in error) {
+      const stderr = typeof error.stderr === "string" ? error.stderr.trim() : "";
+      throw new Error(stderr ? `${command} failed: ${stderr}` : `${command} failed: ${error.message}`);
+    }
+    throw error;
+  }
+}
+function getVoicePublishCommandFromEnv(env = process.env) {
+  const configured = env.OPENZCA_VOICE_PUBLISH_CMD?.trim();
+  return configured && configured.length > 0 ? configured : null;
+}
+function extractPublishedVoiceUrl(stdout) {
+  const lines = stdout.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+  const candidate = lines.at(-1);
+  if (!candidate) {
+    throw new Error("Voice publish command did not print a public URL to stdout");
+  }
+  if (!/^https?:\/\/\S+$/i.test(candidate)) {
+    throw new Error(`Voice publish command returned an invalid URL: ${candidate}`);
+  }
+  return candidate;
+}
+async function normalizeVoiceForPublish(inputPath) {
+  const dir = await fs6.mkdtemp(path6.join(os4.tmpdir(), "openzca-voice-"));
+  const outputPath = path6.join(dir, `${sanitizeOutputBasename(inputPath)}.m4a`);
+  try {
+    await runBinary2("ffmpeg", [
+      "-y",
+      "-v",
+      "error",
+      "-i",
+      inputPath,
+      "-vn",
+      "-map_metadata",
+      "-1",
+      "-ac",
+      "1",
+      "-ar",
+      "44100",
+      "-c:a",
+      "aac",
+      "-b:a",
+      "64k",
+      "-movflags",
+      "+faststart",
+      outputPath
+    ]);
+    await fs6.access(outputPath);
+  } catch (error) {
+    await fs6.rm(dir, { recursive: true, force: true });
+    throw error;
+  }
+  return {
+    path: outputPath,
+    cleanup: async () => {
+      await fs6.rm(dir, { recursive: true, force: true });
+    }
+  };
+}
+async function publishVoiceFile(command, filePath) {
+  try {
+    const { stdout } = await execFileAsync2(
+      "sh",
+      ["-c", `${command} "$1"`, "openzca-voice-publish", filePath],
+      {
+        encoding: "utf8",
+        maxBuffer: 10 * 1024 * 1024
+      }
+    );
+    return extractPublishedVoiceUrl(stdout);
+  } catch (error) {
+    if (error instanceof Error && "stderr" in error) {
+      const stderr = typeof error.stderr === "string" ? error.stderr.trim() : "";
+      throw new Error(
+        stderr ? `Voice publish command failed: ${stderr}` : `Voice publish command failed: ${error.message}`
+      );
+    }
+    throw error;
+  }
+}
+
 // src/lib/reply.ts
 import { ThreadType as ThreadType2 } from "zca-js";
 function prepareReplyMessage(value, params) {
@@ -3133,7 +3328,7 @@ function prepareStoredReplyMessage(value, params) {
   if (storedThreadType !== void 0 && storedThreadType !== params.threadType) {
     throw new Error("Reply source thread type does not match --group.");
   }
-  const storedThreadId = firstString([record.threadId, record.rawThreadId]) ?? void 0;
+  const storedThreadId = firstString2([record.threadId, record.rawThreadId]) ?? void 0;
   if (storedThreadId && storedThreadId !== params.threadId) {
     throw new Error("Reply source belongs to a different thread.");
   }
@@ -3203,7 +3398,7 @@ function parseReplyMessageTtl(value) {
   return Math.trunc(parsed);
 }
 function requireStringLike(values, label) {
-  const value = firstString(values);
+  const value = firstString2(values);
   if (!value) {
     throw new Error(`Missing ${label}.`);
   }
@@ -3220,7 +3415,7 @@ function requireTsString(values, label) {
   }
   throw new Error(`Missing ${label}.`);
 }
-function firstString(values) {
+function firstString2(values) {
   for (const value of values) {
     if (typeof value === "string" && value.trim()) {
       return value.trim();
@@ -3241,7 +3436,7 @@ function isLikelyOpenzcaListenPayload(record) {
   return typeof record.threadId === "string" && (typeof record.senderId === "string" || typeof record.chatType === "string" || typeof record.metadata === "object");
 }
 function inferReplyMessageThreadId(params) {
-  const directThreadId = firstString([
+  const directThreadId = firstString2([
     params.sourceRecord.threadId,
     params.sourceRecord.targetId,
     params.sourceRecord.conversationId,
@@ -3254,7 +3449,7 @@ function inferReplyMessageThreadId(params) {
   if (params.threadType === void 0) {
     return void 0;
   }
-  const idTo = firstString([
+  const idTo = firstString2([
     params.canonicalRecord.idTo,
     params.sourceRecord.idTo,
     params.sourceRecord.toId,
@@ -3263,7 +3458,7 @@ function inferReplyMessageThreadId(params) {
   if (params.threadType === ThreadType2.Group) {
     return idTo;
   }
-  const uidFrom = firstString([
+  const uidFrom = firstString2([
     params.canonicalRecord.uidFrom,
     params.sourceRecord.uidFrom,
     params.sourceRecord.senderId,
@@ -3491,9 +3686,9 @@ function resolveDebugEnabled(command) {
 }
 function resolveDebugFilePath(command) {
   const options = getDebugOptions(command);
-  const configured = options.debugFile?.trim() || process.env.OPENZCA_DEBUG_FILE?.trim() || path6.join(APP_HOME, "logs", "openzca-debug.log");
+  const configured = options.debugFile?.trim() || process.env.OPENZCA_DEBUG_FILE?.trim() || path7.join(APP_HOME, "logs", "openzca-debug.log");
   const normalized = normalizeMediaInput(configured);
-  return path6.isAbsolute(normalized) ? normalized : path6.resolve(process.cwd(), normalized);
+  return path7.isAbsolute(normalized) ? normalized : path7.resolve(process.cwd(), normalized);
 }
 function writeDebugLine(event, details, command) {
   if (!resolveDebugEnabled(command)) {
@@ -3504,7 +3699,7 @@ function writeDebugLine(event, details, command) {
 `;
   const filePath = resolveDebugFilePath(command);
   try {
-    fsSync.mkdirSync(path6.dirname(filePath), { recursive: true });
+    fsSync.mkdirSync(path7.dirname(filePath), { recursive: true });
     fsSync.appendFileSync(filePath, line, "utf8");
   } catch {
   }
@@ -3611,14 +3806,14 @@ function collectIdsFromCacheEntries(entries, keys) {
   return ids;
 }
 function getListenerOwnerLockPath(profile) {
-  return path6.join(getProfileDir(profile), "listener-owner.json");
+  return path7.join(getProfileDir(profile), "listener-owner.json");
 }
 function getListenIpcSocketPath(profile) {
   if (process.platform === "win32") {
     const safe = profile.replace(/[^A-Za-z0-9_-]/g, "_");
     return `\\\\.\\pipe\\openzca-listen-${safe}`;
   }
-  return path6.join(getProfileDir(profile), "listen.sock");
+  return path7.join(getProfileDir(profile), "listen.sock");
 }
 function parsePositiveIntFromUnknown(value) {
   if (typeof value === "number" && Number.isFinite(value) && value > 0) {
@@ -3702,7 +3897,7 @@ function isProcessAlive(pid) {
 }
 async function readListenerOwnerRecord(lockPath) {
   try {
-    const raw = await fs6.readFile(lockPath, "utf8");
+    const raw = await fs7.readFile(lockPath, "utf8");
     const parsed = JSON.parse(raw);
     const pid = parsePositiveIntFromUnknown(parsed.pid);
     if (!pid) return null;
@@ -3722,11 +3917,11 @@ async function readActiveListenerOwner(profile) {
   const lockPath = getListenerOwnerLockPath(profile);
   const record = await readListenerOwnerRecord(lockPath);
   if (!record) {
-    await fs6.rm(lockPath, { force: true });
+    await fs7.rm(lockPath, { force: true });
     return null;
   }
   if (!isProcessAlive(record.pid)) {
-    await fs6.rm(lockPath, { force: true });
+    await fs7.rm(lockPath, { force: true });
     return null;
   }
   return record;
@@ -3742,7 +3937,7 @@ async function acquireListenerOwnerLock(profile, sessionId, command) {
   };
   for (let attempt = 0; attempt < 3; attempt += 1) {
     try {
-      await fs6.writeFile(lockPath, `${JSON.stringify(record, null, 2)}
+      await fs7.writeFile(lockPath, `${JSON.stringify(record, null, 2)}
 `, {
         encoding: "utf8",
         flag: "wx"
@@ -3755,7 +3950,7 @@ async function acquireListenerOwnerLock(profile, sessionId, command) {
           released = true;
           const current = await readListenerOwnerRecord(lockPath);
           if (current && current.pid !== process.pid) return;
-          await fs6.rm(lockPath, { force: true });
+          await fs7.rm(lockPath, { force: true });
           writeDebugLine(
             "listen.owner.released",
             {
@@ -3776,7 +3971,7 @@ async function acquireListenerOwnerLock(profile, sessionId, command) {
           `Another openzca listener already owns profile "${profile}" (pid ${owner.pid}).`
         );
       }
-      await fs6.rm(lockPath, { force: true });
+      await fs7.rm(lockPath, { force: true });
     }
   }
   throw new Error(`Unable to acquire listener ownership for profile "${profile}".`);
@@ -3794,7 +3989,7 @@ async function startListenerIpcServer(api, profile, sessionId, command) {
   }
   const socketPath = getListenIpcSocketPath(profile);
   if (process.platform !== "win32") {
-    await fs6.rm(socketPath, { force: true });
+    await fs7.rm(socketPath, { force: true });
   }
   const uploadTimeoutMs = parsePositiveIntFromEnv(
     "OPENZCA_UPLOAD_IPC_HANDLER_TIMEOUT_MS",
@@ -3975,7 +4170,7 @@ async function startListenerIpcServer(api, profile, sessionId, command) {
         server.close(() => resolve());
       });
       if (process.platform !== "win32") {
-        await fs6.rm(socketPath, { force: true });
+        await fs7.rm(socketPath, { force: true });
       }
       writeDebugLine(
         "listen.ipc.stopped",
@@ -4241,9 +4436,9 @@ async function profileForLogin() {
   await ensureProfile(fallback);
   return fallback;
 }
-async function requireApi(command) {
+async function requireApi(command, options) {
   const profile = await currentProfile(command);
-  const api = await loginWithStoredCredentials(profile);
+  const api = await loginWithStoredCredentials(profile, options);
   return { profile, api };
 }
 function toDbThreadType(groupFlag) {
@@ -6022,7 +6217,7 @@ function toDbRecordFromRecentMessage(params) {
   });
 }
 async function parseCredentialFile(filePath) {
-  const raw = await fs6.readFile(filePath, "utf8");
+  const raw = await fs7.readFile(filePath, "utf8");
   const parsed = JSON.parse(raw);
   if (!parsed.imei || !parsed.cookie || !parsed.userAgent) {
     throw new Error("Credential file must include imei, cookie, and userAgent.");
@@ -6043,7 +6238,7 @@ async function waitForFileContent(filePath, timeoutMs) {
   const startedAt = Date.now();
   while (Date.now() - startedAt < timeoutMs) {
     try {
-      const data = await fs6.readFile(filePath);
+      const data = await fs7.readFile(filePath);
       if (data.length > 0) {
         return data;
       }
@@ -6058,8 +6253,8 @@ async function emitQrBase64FromDetachedLogin(profile, qrPath) {
   if (!scriptPath) {
     throw new Error("Cannot resolve CLI entrypoint for QR base64 mode.");
   }
-  const tempDir = await fs6.mkdtemp(path6.join(os4.tmpdir(), "openzca-qr-"));
-  const targetPath = path6.resolve(qrPath ?? path6.join(tempDir, "qr.png"));
+  const tempDir = await fs7.mkdtemp(path7.join(os5.tmpdir(), "openzca-qr-"));
+  const targetPath = path7.resolve(qrPath ?? path7.join(tempDir, "qr.png"));
   const child = spawn2(
     process.execPath,
     [scriptPath, "--profile", profile, "auth", "login", "--qr-path", targetPath],
@@ -6099,7 +6294,7 @@ function normalizeMessageType(value) {
   if (typeof value !== "string") return "";
   return value.trim().toLowerCase();
 }
-function looksLikeStructuredJsonString(value) {
+function looksLikeStructuredJsonString2(value) {
   const trimmed = value.trim();
   if (trimmed.length < 2) return false;
   const first = trimmed[0];
@@ -6114,7 +6309,7 @@ function normalizeStructuredContent(value, depth = 0) {
   }
   if (typeof value === "string") {
     const trimmed = value.trim();
-    if (!looksLikeStructuredJsonString(trimmed)) {
+    if (!looksLikeStructuredJsonString2(trimmed)) {
       return value;
     }
     try {
@@ -6337,7 +6532,7 @@ function mediaExtFromTypeOrUrl(mediaType, mediaUrl, kind) {
   if (fromType) return fromType;
   try {
     const parsedUrl = new URL(mediaUrl);
-    const ext = path6.extname(parsedUrl.pathname);
+    const ext = path7.extname(parsedUrl.pathname);
     if (ext) return ext;
   } catch {
   }
@@ -6368,20 +6563,20 @@ function parseInboundMediaFetchTimeoutMs() {
   return Math.trunc(parsed);
 }
 function resolveOpenClawMediaDir() {
-  const stateDir = process.env.OPENCLAW_STATE_DIR?.trim() || process.env.CLAWDBOT_STATE_DIR?.trim() || path6.join(os4.homedir(), ".openclaw");
-  return path6.join(stateDir, "media");
+  const stateDir = process.env.OPENCLAW_STATE_DIR?.trim() || process.env.CLAWDBOT_STATE_DIR?.trim() || path7.join(os5.homedir(), ".openclaw");
+  return path7.join(stateDir, "media");
 }
 function resolveInboundMediaDir(profile) {
   const configuredRaw = process.env.OPENZCA_LISTEN_MEDIA_DIR?.trim();
   if (configuredRaw) {
     const configured = normalizeMediaInput(configuredRaw);
-    return path6.isAbsolute(configured) ? configured : path6.resolve(process.cwd(), configured);
+    return path7.isAbsolute(configured) ? configured : path7.resolve(process.cwd(), configured);
   }
   const legacyRequested = process.env.OPENZCA_LISTEN_MEDIA_LEGACY_DIR?.trim() === "1";
   if (legacyRequested) {
-    return path6.join(getProfileDir(profile), "inbound-media");
+    return path7.join(getProfileDir(profile), "inbound-media");
   }
-  return path6.join(resolveOpenClawMediaDir(), "openzca", profile, "inbound");
+  return path7.join(resolveOpenClawMediaDir(), "openzca", profile, "inbound");
 }
 async function cacheInboundMediaToProfile(profile, mediaUrl, kind) {
   const maxBytes = parseMaxInboundMediaBytes();
@@ -6415,11 +6610,11 @@ async function cacheInboundMediaToProfile(profile, mediaUrl, kind) {
     return null;
   }
   const dir = resolveInboundMediaDir(profile);
-  await fs6.mkdir(dir, { recursive: true });
+  await fs7.mkdir(dir, { recursive: true });
   const ext = mediaExtFromTypeOrUrl(mediaType, mediaUrl, kind);
   const id = `${Date.now()}-${Math.random().toString(16).slice(2, 10)}`;
-  const mediaPath = path6.join(dir, `${id}${ext}`);
-  await fs6.writeFile(mediaPath, data);
+  const mediaPath = path7.join(dir, `${id}${ext}`);
+  await fs7.writeFile(mediaPath, data);
   return { mediaPath, mediaType };
 }
 async function cacheRemoteMediaEntries(params) {
@@ -6640,7 +6835,7 @@ function collectInboundMentions(value, sink, rawText, depth = 0) {
     return;
   }
   if (typeof value === "string") {
-    if (!looksLikeStructuredJsonString(value)) return;
+    if (!looksLikeStructuredJsonString2(value)) return;
     try {
       const parsed = JSON.parse(value);
       collectInboundMentions(parsed, sink, rawText, depth + 1);
@@ -6929,7 +7124,7 @@ auth.command("login").description("Login with QR code").option("-q, --qr-path <p
 auth.command("login-cred [file]").alias("login-creds").description("Login using credential JSON file").action(
   wrapAction(async (file, command) => {
     const profile = await currentProfile(command);
-    const credentials = file ? await parseCredentialFile(path6.resolve(normalizeMediaInput(file))) : toCredentials(
+    const credentials = file ? await parseCredentialFile(path7.resolve(normalizeMediaInput(file))) : toCredentials(
       await loadCredentials(profile) ?? (() => {
         throw new Error(
           `No saved credentials for profile "${profile}". Run: openzca auth login`
@@ -7036,7 +7231,7 @@ dbCmd.command("reset").option("-y, --yes", "Delete the SQLite DB file for the ac
     const removedPaths = [];
     const deleteIfExists = async (filename) => {
       try {
-        await fs6.unlink(filename);
+        await fs7.unlink(filename);
         removedPaths.push(filename);
       } catch (error) {
         if (error.code !== "ENOENT") {
@@ -7749,53 +7944,108 @@ msg.command("voice <threadId> [file]").option("-u, --url <url>", "Voice URL (rep
       }
       const urlInputs = files.filter((entry) => isHttpUrl(entry));
       const localInputs = files.filter((entry) => !isHttpUrl(entry));
+      const publishCommand = getVoicePublishCommandFromEnv();
+      const ffmpegAvailable = localInputs.length > 0 && publishCommand ? await isFfmpegAvailable() : false;
+      const usePublishFlow = localInputs.length > 0 && Boolean(publishCommand) && ffmpegAvailable;
       writeDebugLine(
         "msg.voice.inputs",
         {
           threadId,
           isGroup: Boolean(opts.group),
           localInputs,
-          urlInputs
+          urlInputs,
+          publishConfigured: Boolean(publishCommand),
+          ffmpegAvailable: localInputs.length > 0 ? ffmpegAvailable : void 0,
+          mode: usePublishFlow ? "publish" : "legacy"
         },
         command
       );
-      const downloaded = await downloadUrlsToTempFiles(urlInputs);
-      try {
-        const attachments = [...localInputs, ...downloaded.files];
-        await assertFilesExist(attachments);
-        const results = [];
-        const uploaded = await api.uploadAttachment(attachments, threadId, type);
-        for (const item of uploaded) {
-          if (item.fileType === "others" || item.fileType === "video") {
-            results.push(await sendVoice({ voiceUrl: item.fileUrl }, threadId, type));
+      await assertFilesExist(localInputs);
+      const publishedLocals = [];
+      let uploadedLocals = [];
+      if (usePublishFlow) {
+        for (const localInput of localInputs) {
+          const normalized = await normalizeVoiceForPublish(localInput);
+          try {
+            const mediaUrl = await publishVoiceFile(publishCommand, normalized.path);
+            publishedLocals.push({
+              mediaPath: localInput,
+              mediaUrl
+            });
+          } finally {
+            await normalized.cleanup();
           }
         }
-        if (results.length === 0) {
-          throw new Error(
-            "No valid voice attachment generated. Use an audio file (e.g. .aac, .mp3, .m4a, .wav, .ogg)."
-          );
+      } else if (localInputs.length > 0) {
+        uploadedLocals = await withUploadListener(
+          api,
+          command,
+          async () => api.uploadAttachment(localInputs, threadId, type)
+        );
+      }
+      const pendingPublished = [...publishedLocals];
+      const pendingUploaded = [...uploadedLocals];
+      const outboundVoices = [];
+      for (const entry of files) {
+        if (isHttpUrl(entry)) {
+          outboundVoices.push({
+            mediaUrl: entry
+          });
+          continue;
         }
-        output(results, false);
-        if (await shouldWriteToDb(profile)) {
-          scheduleDbWrite(profile, command, "msg.voice.db.persist_error", async () => {
-            await persistOutgoingMessageBestEffort({
-              profile,
-              api,
-              threadId,
-              group: opts.group,
-              msgType: "voice",
-              response: results,
-              rawPayload: uploaded,
-              media: uploaded.map((item) => ({
-                mediaKind: "voice",
-                mediaUrl: "fileUrl" in item && typeof item.fileUrl === "string" ? item.fileUrl : void 0,
-                rawJson: JSON.stringify(item)
-              }))
-            });
+        if (usePublishFlow) {
+          const nextPublished = pendingPublished.shift();
+          if (!nextPublished) {
+            throw new Error(`Voice publish flow lost local file mapping for: ${entry}`);
+          }
+          outboundVoices.push(nextPublished);
+          continue;
+        }
+        const nextUploaded = pendingUploaded.shift();
+        if (!nextUploaded) {
+          throw new Error(`Voice upload flow lost local file mapping for: ${entry}`);
+        }
+        if (nextUploaded.fileType === "others" || nextUploaded.fileType === "video") {
+          outboundVoices.push({
+            mediaPath: entry,
+            mediaUrl: nextUploaded.fileUrl,
+            rawJson: JSON.stringify(nextUploaded)
           });
         }
-      } finally {
-        await downloaded.cleanup();
+      }
+      if (outboundVoices.length === 0) {
+        throw new Error(
+          "No valid voice attachment generated. Use an audio file (e.g. .aac, .mp3, .m4a, .wav, .ogg)."
+        );
+      }
+      const results = [];
+      for (const item of outboundVoices) {
+        results.push(await sendVoice({ voiceUrl: item.mediaUrl }, threadId, type));
+      }
+      output(results, false);
+      if (await shouldWriteToDb(profile)) {
+        scheduleDbWrite(profile, command, "msg.voice.db.persist_error", async () => {
+          await persistOutgoingMessageBestEffort({
+            profile,
+            api,
+            threadId,
+            group: opts.group,
+            msgType: "voice",
+            response: results,
+            rawPayload: {
+              mode: usePublishFlow ? "publish" : "legacy",
+              directUrls: urlInputs,
+              published: publishedLocals,
+              uploaded: uploadedLocals
+            },
+            media: outboundVoices.map((item) => ({
+              mediaKind: "voice",
+              mediaPath: item.mediaPath,
+              mediaUrl: item.mediaUrl,
+              rawJson: item.rawJson
+            }))
+          });
+        });
       }
     }
   )
@@ -8255,23 +8505,23 @@ group.command("create <name> <members...>").description("Create new group").acti
   })
 );
 var groupPoll = group.command("poll").description("Group poll management");
-groupPoll.command("create <groupId>").requiredOption("-q, --question <text>", "Poll question").requiredOption("-o, --option <text>", "Poll option (repeatable)", collectValues, []).option("--multi", "Allow multiple choices").option("--allow-add-option", "Allow members to add new options").option("--hide-vote-preview", "Hide results until the member votes").option("--anonymous", "Hide voters").option("--expire-ms <ms>", "Poll expiration time in milliseconds").description("Create a poll in a group").action(
+groupPoll.command("create <groupId>").requiredOption("-q, --question <text>", "Poll question").requiredOption("-o, --option <text>", "Poll option (repeatable)", collectValues, []).option("-j, --json", "JSON output").option("--multi", "Allow multiple choices").option("--allow-add-option", "Allow members to add new options").option("--hide-vote-preview", "Hide results until the member votes").option("--anonymous", "Hide voters").option("--expire-ms <ms>", "Poll expiration time in milliseconds").description("Create a poll in a group").action(
   wrapAction(
     async (groupId, opts, command) => {
       const pollOptions = buildCreatePollOptions(opts);
       const { api } = await requireApi(command);
-      output(await api.createPoll(pollOptions, groupId), false);
+      output(await api.createPoll(pollOptions, groupId), shouldOutputJson(opts));
     }
   )
 );
-groupPoll.command("detail <pollId>").description("Get poll detail").action(
-  wrapAction(async (pollId, command) => {
+groupPoll.command("detail <pollId>").option("-j, --json", "JSON output").description("Get poll detail").action(
+  wrapAction(async (pollId, opts, command) => {
     const normalizedPollId = parsePollId(pollId);
     const { api } = await requireApi(command);
-    output(await api.getPollDetail(normalizedPollId), false);
+    output(await api.getPollDetail(normalizedPollId), shouldOutputJson(opts));
   })
 );
-groupPoll.command("vote <pollId>").requiredOption("-o, --option <id>", "Poll option id (repeatable)", collectValues, []).description("Vote on a group poll").action(
+groupPoll.command("vote <pollId>").requiredOption("-o, --option <id>", "Poll option id (repeatable)", collectValues, []).option("-j, --json", "JSON output").description("Vote on a group poll").action(
   wrapAction(
     async (pollId, opts, command) => {
       const normalizedPollId = parsePollId(pollId);
@@ -8281,22 +8531,22 @@ groupPoll.command("vote <pollId>").requiredOption("-o, --option <id>", "Poll opt
         normalizedPollId,
         optionIds.length === 1 ? optionIds[0] : optionIds
       );
-      output(response, false);
+      output(response, shouldOutputJson(opts));
     }
   )
 );
-groupPoll.command("lock <pollId>").description("Close a poll").action(
-  wrapAction(async (pollId, command) => {
+groupPoll.command("lock <pollId>").option("-j, --json", "JSON output").description("Close a poll").action(
+  wrapAction(async (pollId, opts, command) => {
     const normalizedPollId = parsePollId(pollId);
     const { api } = await requireApi(command);
-    output(await api.lockPoll(normalizedPollId), false);
+    output(await api.lockPoll(normalizedPollId), shouldOutputJson(opts));
   })
 );
-groupPoll.command("share <pollId>").description("Share a poll").action(
-  wrapAction(async (pollId, command) => {
+groupPoll.command("share <pollId>").option("-j, --json", "JSON output").description("Share a poll").action(
+  wrapAction(async (pollId, opts, command) => {
     const normalizedPollId = parsePollId(pollId);
     const { api } = await requireApi(command);
-    output(await api.sharePoll(normalizedPollId), false);
+    output(await api.sharePoll(normalizedPollId), shouldOutputJson(opts));
   })
 );
 group.command("rename <groupId> <name>").description("Rename group").action(
@@ -8751,7 +9001,7 @@ me.command("last-online <userId>").description("Get last online of a user").acti
     output(await api.lastOnline(userId), false);
   })
 );
-program.command("listen").description("Listen for real-time incoming messages").option("-e, --echo", "Echo incoming text message").option("-p, --prefix <prefix>", "Only process text starting with prefix").option("-w, --webhook <url>", "POST message payload to webhook").option("-r, --raw", "Output JSON line payload").option("--db", "Force DB persistence for this listener session").option("--no-db", "Disable DB persistence for this listener session").option("-k, --keep-alive", "Auto restart listener on disconnect").option(
+program.command("listen").description("Listen for real-time incoming messages").option("-e, --echo", "Echo incoming text message").option("-p, --prefix <prefix>", "Only process text starting with prefix").option("-w, --webhook <url>", "POST message payload to webhook").option("-r, --raw", "Output JSON line payload").option("--self", "Include events produced by the logged-in account").option("--db", "Force DB persistence for this listener session").option("--no-db", "Disable DB persistence for this listener session").option("-k, --keep-alive", "Auto restart listener on disconnect").option(
   "--supervised",
   "Supervisor mode (disable internal retry ownership; emit lifecycle events in --raw)"
 ).option(
@@ -8763,7 +9013,8 @@ program.command("listen").description("Listen for real-time incoming messages").
 ).action(
   wrapAction(
     async (opts, command) => {
-      const { profile, api } = await requireApi(command);
+      const selfListen = Boolean(opts.self);
+      const { profile, api } = await requireApi(command, { selfListen });
       const supervised = Boolean(opts.supervised);
       const defaultRecycleMs = 30 * 60 * 1e3;
       const recycleMs = parseNonNegativeIntOption("--recycle-ms", opts.recycleMs) ?? parseNonNegativeIntOption(
@@ -8856,6 +9107,7 @@ program.command("listen").description("Listen for real-time incoming messages").
             maxMediaFiles: parseMaxInboundMediaFiles(),
             includeMediaUrl: process.env.OPENZCA_LISTEN_INCLUDE_MEDIA_URL?.trim() ?? null,
             keepAlive: Boolean(opts.keepAlive),
+            selfListen,
             keepAliveRestartDelayMs: Boolean(opts.keepAlive) ? keepAliveRestartDelayMs : void 0,
             keepAliveRestartOnAnyClose: Boolean(opts.keepAlive) ? keepAliveRestartOnAnyClose : void 0,
             supervised,
@@ -9020,6 +9272,7 @@ ${replyContextText}` : replyContextText;
             rawText
           });
           const mentionIds = mentions.map((item) => item.uid);
+          const poll = extractInboundPollInfo(messageData, parsedContent);
           const timestamp = toEpochSeconds(message.data.ts);
           const timestampMs = toEpochMs(message.data.ts);
           const payload = {
@@ -9048,6 +9301,11 @@ ${replyContextText}` : replyContextText;
             mediaKind: mediaKind ?? void 0,
             mentions: mentions.length > 0 ? mentions : void 0,
             mentionIds: mentionIds.length > 0 ? mentionIds : void 0,
+            poll: poll ?? void 0,
+            pollId: poll?.pollId,
+            pollTitle: poll?.title,
+            pollOptionIds: poll?.optionIds,
+            rawMessage: poll ? message.data : void 0,
             metadata: {
               isGroup: message.type === ThreadType3.Group,
               chatType,
@@ -9077,7 +9335,12 @@ ${replyContextText}` : replyContextText;
               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
+              mentionCount: mentions.length > 0 ? mentions.length : void 0,
+              poll: poll ?? void 0,
+              pollId: poll?.pollId,
+              pollTitle: poll?.title,
+              pollOptionIds: poll?.optionIds,
+              rawMessage: poll ? message.data : void 0
             },
             // Backward-compatible convenience fields.
             chatType,
@@ -9180,6 +9443,69 @@ ${replyContextText}` : replyContextText;
             }
           }
         });
+        api.listener.on("group_event", async (event) => {
+          const poll = extractInboundPollInfo(event);
+          if (!poll) return;
+          const eventData = asObject(event.data);
+          const groupTopic = asObject(eventData?.groupTopic);
+          const actorId = getStringCandidate(eventData ?? {}, ["sourceId", "creatorId", "actorId", "editorId"]) || getStringCandidate(groupTopic ?? {}, ["creatorId", "editorId"]);
+          const threadName = getStringCandidate(eventData ?? {}, ["groupName"]);
+          const timestampSource = eventData?.time ?? groupTopic?.createTime ?? groupTopic?.editTime ?? Date.now();
+          const timestamp = toEpochSeconds(timestampSource);
+          const payload = {
+            kind: "group_event",
+            event: "poll",
+            threadId: event.threadId,
+            targetId: event.threadId,
+            conversationId: event.threadId,
+            type: ThreadType3.Group,
+            timestamp,
+            groupEventType: event.type,
+            act: event.act,
+            poll,
+            pollId: poll.pollId,
+            pollTitle: poll.title,
+            pollOptionIds: poll.optionIds,
+            rawGroupEvent: event,
+            metadata: {
+              isGroup: true,
+              chatType: "group",
+              threadId: event.threadId,
+              targetId: event.threadId,
+              threadName: threadName || void 0,
+              senderId: actorId || void 0,
+              fromId: actorId || void 0,
+              timestamp,
+              groupEventType: event.type,
+              act: event.act,
+              poll,
+              pollId: poll.pollId,
+              pollTitle: poll.title,
+              pollOptionIds: poll.optionIds,
+              rawGroupEvent: event
+            },
+            chatType: "group",
+            senderId: actorId || void 0,
+            senderName: void 0,
+            senderDisplayName: void 0
+          };
+          writeDebugLine(
+            "listen.group_event.poll",
+            {
+              profile,
+              threadId: event.threadId,
+              groupEventType: event.type,
+              act: event.act,
+              pollId: poll.pollId,
+              pollTitle: poll.title,
+              sessionId
+            },
+            command
+          );
+          if (opts.raw) {
+            console.log(JSON.stringify(payload));
+          }
+        });
         api.listener.on("error", (error) => {
           writeDebugLine(
             "listen.error",

package/package.json

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