@agent-wechat/cli 0.14.0 → 0.15.1

package/README.md

@@ -90,6 +90,12 @@ Send options:
 
 Media options:
 - `--output <path>` — save to a specific file path
+- `--full` — require an original-resolution image
+- `--thumbnail` — save the cached preview
+- `--best` — explicitly choose the default best-available image behavior
+
+Media retrieval does not open a chat. Use `wx chats open <chatId>` separately
+if WeChat needs to cache a regular photo's standard-size copy.
 
 ### Sessions
 

package/dist/cli.js

@@ -3582,6 +3582,23 @@ var WeChatClient = class {
   async sendMessage(params) {
     return this.post("/api/messages/send", params);
   }
+  async createVoiceJob(chatId, audio, idempotencyKey) {
+    const form = new FormData();
+    form.set("chatId", chatId);
+    form.set("audio", new Blob([new Uint8Array(audio)]), "voice-audio");
+    const headers = { ...this.headers, "Idempotency-Key": idempotencyKey };
+    delete headers["Content-Type"];
+    const res = await fetch(`${this.base}/api/messages/voice`, { method: "POST", headers, body: form });
+    if (!res.ok)
+      throw new Error(`${res.status} ${res.statusText}: ${await res.text()}`);
+    return res.json();
+  }
+  async getVoiceJob(jobId) {
+    return this.get(`/api/messages/voice/${encodeURIComponent(jobId)}`);
+  }
+  async cancelVoiceJob(jobId) {
+    return this.post(`/api/messages/voice/${encodeURIComponent(jobId)}/cancel`);
+  }
   // ---- Debug ----
   async screenshot() {
     return this.get("/api/debug/screenshot");
@@ -7912,7 +7929,7 @@ import qrTerminal from "qrcode-terminal";
 import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
-var VERSION = "0.14.0";
+var VERSION = "0.15.1";
 var CONTAINER_NAME = "agent-wechat";
 var GHCR_IMAGE = "ghcr.io/thisnick/agent-wechat";
 var DEFAULT_PORT = 6174;
@@ -8058,14 +8075,28 @@ var messagesCmd = program2.command("messages").description("Message commands");
 messagesCmd.command("list <chatId>").description("List messages for a chat").option("-l, --limit <number>", "Maximum number of messages", "50").option("-o, --offset <number>", "Skip first N messages", "0").option("-j, --json", "Output as JSON").action(async (chatId, opts) => {
   await cmdMessages(getClient(), chatId, parseInt(opts.limit, 10), parseInt(opts.offset, 10), opts.json ?? false);
 });
-messagesCmd.command("media <chatId> <localId>").description("Save a media attachment (full-resolution image, file, or voice)").option("--thumbnail", "Retrieve an image thumbnail instead of full resolution").option("-o, --output <path>", "Output file path").action(async (chatId, localIdStr, opts) => {
-  await cmdMedia(getClient(), chatId, parseInt(localIdStr, 10), opts.output, opts.thumbnail);
+messagesCmd.command("media <chatId> <localId>").description("Save a media attachment (best available image, file, or voice)").option("--full", "Require the original-resolution image").option("--thumbnail", "Retrieve an image thumbnail instead of full resolution").option("--best", "Retrieve the best available image (default)").option("-o, --output <path>", "Output file path").action(async (chatId, localIdStr, opts) => {
+  if (Number(!!opts.full) + Number(!!opts.thumbnail) + Number(!!opts.best) > 1) {
+    console.error("Choose only one of --full, --thumbnail, or --best.");
+    process.exit(1);
+  }
+  const quality = opts.full ? "full" : opts.thumbnail ? "thumbnail" : "best";
+  await cmdMedia(getClient(), chatId, parseInt(localIdStr, 10), opts.output, quality);
 });
-messagesCmd.command("send <chatId>").description("Send a message to a chat").option("--text <text>", "Text message to send").option("--image <path>", "Image file to send").option("--file <path>", "File to send").action(async (chatId, opts) => {
-  if (!opts.text && !opts.image && !opts.file) {
-    console.error("Must provide --text, --image, or --file");
+messagesCmd.command("send <chatId>").description("Send a message to a chat").option("--text <text>", "Text message to send").option("--image <path>", "Image file to send").option("--file <path>", "File to send").option("--voice <path>", "Record audio as one or more voice notes").option("--detach", "Return after the voice job is queued").action(async (chatId, opts) => {
+  if (!opts.text && !opts.image && !opts.file && !opts.voice) {
+    console.error("Must provide --text, --image, --file, or --voice");
     process.exit(1);
   }
+  if (opts.voice) {
+    if (opts.text || opts.image || opts.file) throw new Error("--voice must be sent on its own");
+    const audio = fs.readFileSync(opts.voice);
+    const job = await getClient().createVoiceJob(chatId, audio, randomBytes(16).toString("hex"));
+    console.log(`Voice job: ${job.jobId}`);
+    if (!opts.detach) await waitVoiceJob(getClient(), job.jobId);
+    return;
+  }
+  if (opts.detach) throw new Error("--detach requires --voice");
   let image;
   if (opts.image) {
     if (!fs.existsSync(opts.image)) {
@@ -8088,6 +8119,34 @@ messagesCmd.command("send <chatId>").description("Send a message to a chat").opt
   }
   await cmdSend(getClient(), chatId, opts.text, image, file);
 });
+var voiceCmd = messagesCmd.command("voice").description("Inspect or cancel voice jobs");
+voiceCmd.command("status <jobId>").action(async (jobId) => {
+  console.log(JSON.stringify(await getClient().getVoiceJob(jobId), null, 2));
+});
+voiceCmd.command("cancel <jobId>").action(async (jobId) => {
+  const job = await getClient().cancelVoiceJob(jobId);
+  console.log(`Cancellation requested for ${job.jobId}`);
+});
+async function waitVoiceJob(client, jobId) {
+  let lastProgress = "";
+  for (; ; ) {
+    const job = await client.getVoiceJob(jobId);
+    const verified = job.chunks.filter((chunk) => chunk.status === "verified").length;
+    const progress = `${job.status}: ${verified}/${job.chunks.length} notes verified`;
+    if (progress !== lastProgress) {
+      console.log(progress);
+      lastProgress = progress;
+    }
+    if (job.status === "completed") {
+      console.log(`Message IDs: ${job.chunks.map((chunk) => chunk.messageId).join(", ")}`);
+      return;
+    }
+    if (["failed", "cancelled", "needs_review"].includes(job.status)) {
+      throw new Error(`${job.status}: ${job.error ?? "No further details"}. Job ${jobId}; do not resend the whole recording.`);
+    }
+    await new Promise((resolve) => setTimeout(resolve, 1e3));
+  }
+}
 program2.command("update").description("Update the agent-server binary in the running container to match CLI version").action(cmdUpdate);
 program2.command("screenshot").description("Save screenshot to file").argument("[file]", "Output file path", "screenshot.png").action(async (file) => {
   await cmdScreenshot(getClient(), file);
@@ -8336,8 +8395,8 @@ async function cmdMessages(client, chatId, limit = 50, offset = 0, json = false)
   console.log(`
 ${messages.length} message(s) shown.`);
 }
-async function cmdMedia(client, chatId, localId, outputPath, thumbnail = false) {
-  const result = await client.getMedia(chatId, localId, thumbnail ? "thumbnail" : "full");
+async function cmdMedia(client, chatId, localId, outputPath, quality = "best") {
+  const result = await client.getMedia(chatId, localId, quality);
   if (result.type === "unsupported") {
     console.error("No media found for this message (unsupported type or not found).");
     process.exit(1);
@@ -8350,9 +8409,10 @@ async function cmdMedia(client, chatId, localId, outputPath, thumbnail = false)
   if (result.data) {
     const buffer = Buffer.from(result.data, "base64");
     fs.writeFileSync(outFile, buffer);
-    console.log(`Saved ${result.type} to ${outFile} (${buffer.length} bytes)`);
+    const variant = result.type === "image" && result.quality ? ` (${result.quality})` : "";
+    console.log(`Saved ${result.type}${variant} to ${outFile} (${buffer.length} bytes)`);
   } else if (result.type === "image") {
-    console.error(`Requested image ${thumbnail ? "thumbnail" : "full resolution"} is not yet available.`);
+    console.error(`Requested image ${quality} is not yet available.${quality === "full" ? " Regular phone sends may have no Original copy; try without --full." : ""}`);
     process.exit(1);
   } else if (result.type === "video") {
     console.error("Video not yet downloaded by WeChat. Try playing the video in the app first.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-wechat/cli",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "type": "module",
   "bin": {
     "wx": "./dist/cli.js"
@@ -17,7 +17,7 @@
     "@types/node": "^22",
     "@types/qrcode-terminal": "^0.12.2",
     "typescript": "^5.4.5",
-    "@agent-wechat/shared": "0.2.0"
+    "@agent-wechat/shared": "0.3.1"
   },
   "publishConfig": {
     "access": "public",